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Introduction 



This chapter describes: 

■ The contents and organization of this manual. 

■ The typographical conventions used. 

■ Other documentation you may need to read. 



Should You Be Reading this IVIanual? 

The primary audience for this manual is system administrators of systems 
running the HP Visual User Environment (HP VUE). Since HP VUE provides 
many interactive customization capabilities, most end-users do not need to 
know the system in the detail described here. 

However, there are some things that cannot be done interactively that an 
end-user might some day need to do — for example, converting a screen dump 
from one graphics format to another, or adding a keybinding. These things 
aren't particularly hard to do; they're just not done very often by typical 
users, and they are covered in this manual rather than in the HP Visual User 
Environment User's Guide. So, if you are not a system administrator but 
nevertheless have found yourself faced with having to read a section of this 
manual, don't panic. 

Note System administration information for systems running the X 



Window System without HP VUE is contained in the manual 
Using the X Window System, HP part number B1171-90043. 
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How this Manual Is Organized 

Chapter Contents 

1 Introduces this manual and describes the other documentation 
available to you. 

2 Describes the hardware and software that make up a typical 
system and explains how they fit together. 

3 Covers configuring the system for multiple screens and how HP 
VUE implements Native Language Support. 

4 Covers how HP VUE implements distributed operation. 

5 Covers the HP VUE Login Manager, which is responsible for 
starting the X server and displaying the login screen. 

6 Covers the HP VUE Session Manager, which provides the 
ability to save and restore previous sessions. 

7 Describes how to construct command lines to execute programs 
locally or remotely. 

8 Explains how clients obtain resources and how to modify the 
resource database in an environment of managed sessions. 

9 Introduces the HP VUE clients, explains how HP VUE 
manages color resources, and explains client caching. 

10 Describes how HP VUE implements fonts. 

11 Describes the HP VUE Window Manager, including menus, 
button bindings, key bindings, and workspace backdrops. 

12 Describes the file types and action definition databases that 
provide the ability to start processes from the file manager and 
workspace manager. 

13 Explains how to customize the HP VUE Workspace Manager 
(front panel). 

14 Discusses how to run sessions from a startup script and how to 
run a non-HP VUE environment from a system, console. 
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Covers compatibility and porting issues for Softbench and HP 
VUE. 



Typographical Conventions 

Table 1-1. Typographical Conventions. 



If you see . . . 


It means . . . 


computer text 


File names, directory names, displayed text, or text that you type 
exactly as shown. For example, inittab is a file name and 
$HOME/ . vue/types is a directory path. 


italic text 


A book title, emphasized text, or a parameter for which you must 
supply an allowable entry. For example. 




xterm -title name 




means you type xterm -title followed by a name. 


o 


Represents a key on the keyboard. For example, 


(CTRL) UJ 


means you hold down the [CTRL) key and press [l). 


C ] 


Brackets enclose optional text, usually parameters or command-line 
options. For example. 




xload [-rv] ft 




means that you must type xload but don't have to type -rv unless 
you need its particular functionality. 


i y 


Braces enclose a list of mutually exclusive options. For example, 




"'* ' { I« } 




means that option r can be set to either on or off, but not both. 


bold text 


The definition of this term follows. Additionally, the term may be 
defined in the glossary. 
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Case Sensitivity and Other Typographical Tips 

Most systems distinguish between upper-case and lower-case letters. A file 
named vuewmrc is not the same file as Vuewmrc. Use upper-case letters only 
where indicated. 

Beware that the number "1" looks like a lower-case letter "1" (el), and that "0" 
(zero) closely resembles the upper-case letter "0". 

White space (extra spaces or tabs) at the end of a command line in a text file 
sometimes alters the meaning of the command. After modifying a file, check 
for unwanted white space. 



Where to Find Additional Information 

To order any of the manuals listed here, call: 

■ HP Direct at 1-800-538-8787. 

■ Your HP Sales Representative. 

and ask for the part numbers listed for the manuals. 

The following books provide additional information about HP VUE. 
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To Learn More About . . . 

Preliminary configuration and 
updating to HP VUE 2.01 on 
HP-UX 7.* systems. 

Preliminary configuration for HP 
VUE on HP-UX 8.* systems 
(including 8.0). 

Preliminary configuration for HP 
VUE on other operating systems. 

Using HP VUE 

Writing applications for HP VUE 

Running the X Window System 
without HP VUE; reference pages 
for the X Window System 



Read . . . 


Part 




Number 


HP Visual User Environment 


B1171- 


Installation Guide 


90006 


HP Visual User Environment 


B1171- 


Configuration Guide 


90041 



HP Visual User Environment 
Configuration Guide for your 
operating system. 

HP Visual User Environment 
User's Guide 

HP Visual User Environment 
Programmer's Guide 

Using the X Window System 



B1171- 
90042 

B1171- 
90024 

B1171- 
90043 



These books provide additional information about HP OSF/Motif, the X 
Window System, widgets, and widget programming: 



HP OSF/Motif Style Guide 

HP OSF/Motif Programmer's Reference 

HP OSF/Motif Programmer's Guide 

The X Window System: OSF/Motif Edition 

Mastering OSF/Motif Widgets 



B1171-90032 
B1171-90033 
B1171-90034 
ISBN 0-13-497074-8 
5010-7168 
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The following books about the X Window System and OSF/Motif might prove 
useful: 

■ Introduction to the X Window System by Oliver Jones. Prentice Hall, 
Englewood Cliffs, NJ:1989. 

■ The X Window System in a Nutshell. O'Reilly and Associates, Newton, 
MA:1990. 

■ Xlih Programming Manual for Version 11 hy Adrian Nye. O'Reilly and 
Associates, Newton, MA: 1990. 

■ Xlib Reference Manual for Version 11 edited by Adrian Nye. O'Reilly and 
Associates, Newton, MA: 1990. 

■ X Window System User's Guide OSF/Motif Edition by Valerie Querela and 
Tim O'Reilly. O'Reilly and Associates, Newton, MA:1991. 

■ X Protocol Reference Man wa/ O'Reilly and Associates, Newton, MA:1990. 

■ X Window Systems Programming and Applications with Xt by Douglas A. 
Young. Prentice Hall, Englewood Cliffs, NJ:1990. 

■ OSF/Motif User's Guide. Prentice-Hall, Englewood Cliffs, NJ:1990. 

■ Advanced X Window Applications Programming by Eric F. Johnson and 
Kevin Reichard. MIS Press, Portland, OR:1990. 
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File Locations on OSF/1 and Domain/OS Systems 

There are several fundamental differences in the file locations on HP-UX, 
Domain/OS, and OSF/1 systems that affect HP VUE. 

For example, the following Xll system directories have different locations on 
OSF/1 and Domain/ OS systems than on HP-UX systems. 

HP-UX Location OSF/1 and Domain/OS Location 

/usr/lib/Xll /usr/Xll/lib 

/usr/bin/Xll /usr/Xll/bin 



The HP VUE documentation uses the HP-UX paths. 

On OSF/1 and Domain/OS systems, HP VUE uses links between the HP-UX 
directories and their corresponding OSF/1 — Domain/ OS directories. The 
actual files reside in their OSF/1 — Domain/OS locations. 

For example, an OSF/1 or Domain/OS user executing: 

cd /usr/lib/Xll 
Is 

sees the contents of /usr/Xll/lib. 

Note For Domain/OS Users: The links set up for the Xll system 

I directories use the absolute paths to the local system files. For 

^B example, executing: 

cd //sysb/usr/lib/Xll 
Is 

on local system //sysa displays the contents of 
//sysa/usr/Xll/lib. 
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Birdseye HP VUE 



This chapter describes: 

■ The major layers of software on a typical system running HP VUE. 

■ A brief description of the HP VUE software. 



The Layers of Software on HP VUE Systems 

The software that provides the appearance and behavior of HP VUE has three 
layers. 



NfOJE Clients 

Window manager 
File manager 
Style manager 
Help manager 
etc. 



X Clients 

xrdb 

bitmap 

xterm 

xfd 

etc. 



X Window System 



HP-UX Operating System 



Figure 2-1. Software Layers. 

To an end-user, the layers blend together into a single working environment. 
However, from a system administration point of view, it is important to know 
how the layers work together. 



Birdseye HP VUE 2-1 



The Operating System 

The operating system is the software that controls the operation of the 
computer system. The operating system provides a multi-user, multi-tasking 
environment. 

HP VUE runs on a variety of operating systems. Most of the appearance 
and behavior, and many of the configuration issues, are the same for the 
various operating systems. Major differences are covered in the HP Visual 
User Environment Configuration Guide for your operating system. Smaller 
differences are noted in the other HP VUE documents. 

The X Window System 

The central part of the X Window System is the X server, also called the 
display server. The X server is the program that controls the screen, keyboard, 
and mouse, and processes communication requests. The server updates the 
windows on the screen as a client generates new information or as you enter 
information through an input device. All client programs communicate through 
the server. 

The X clients are programs designed to run under the X Window System, with 
or without HP VUE. 

There are a number of clients that are included with the X Window System. 
For example, the bitmap client creates custom bitmaps. The xrdb client lets 
you view and modify current resources. 

Some clients (for example, xwininf o and xmodmap) do not create windows. 
They use an existing terminal emulation window to display their output. 

The X clients are described in the manual Using the X Window System. 

HP VUE 

HP VUE is a set of enhancements to the user interface for the X Window 
System. It consists of a series of clients that provide a visual interface for 
logging in and out, invoking applications, managing files, and customizing 
systems. 
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The HP VUE Clients 

To the system administrator, HP VUE is a set of clients and associated 
configuration and resource files. These are the major components of HP VUE: 

Table 2-1. Major Components of HP VUE. 



Component 


Client 


Description 


Login manager 


vuelogin 


Performs configuration activities, starts the server, 
and performs the login activities. 


Session 
manager 


vuesession 


Saves and restore sessions. 


Window 
manager 


vuewm 


Provides window and workspace management. 


Workspace 
manager (front 
panel) 


— 


Part of vuewm. Provides a panel of controls for 
managing workspaces and sessions. Also called the 
front panel. 


File manager 


vuef ile 


Graphical interface for file management. 


Style manager 


vuestyle 


Lets the user customize the appearance and 
behavior of the system interactively. 


Help manager 


vuehelp 


Provides on-line instructions and context-sensitive 
help. 


Terminal 
emulator 


hpterm or 
xterm 


Provides the ability to emulate terminals. The 
default terminal emulator for HP-UX is hpterm. 
For other operating systems, the default is xterm. 


vuepad editor 


vuepad 


Provides text editing. 



HP VUE clients are able to communicate with the portions of HP VUE that 
control certain aspects of the appearance and behavior. For example, viewable 
HP VUE clients (clients that have their own windows) respond to color changes 
made using the HP VUE Style Manager. 
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The Window Manager— A Special Client 

If you think of your computer screen as a surface on which things are 
displayed, you can think of workspaces as a stack of surfaces. At any one time, 
only one workspace is visible, and it fills the entire screen. A control switch in 
the workspace manager (also called the front panel) lets you switch from the 
current workspace to another one in the stack. 

Each workspace can contain a number of windows. In functionality, each 
window is equivalent to a full-sized display terminal and can run a separate 
process. 



Physical 
Screen 







^^U 



go 



Workspace <1 Workspace #2 Workspace «3 

Figure 2-2. Windows in Workspaces. 

The window manager lets you establish one or more workspaces and 
dynamically control the size, shape, state (icon or normal), and location of the 
windows in those workspaces. It also supplies the frame and window menu for 
each window, the workspace manager, and the workspace menu. 

The window manager is the first client started during a session after the session 
manager has been started. All other clients with their own windows must be 
able to interact with the window manager. 

The window manager is covered in chapter 11. 
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other HP VUE Components 

HP VUE includes various other components that contribute to its functionality: 

File Management Database Provides a database of file types and 

action definitions which allows the user 
to invoke commands and applications 
graphically. 



Broadcast Message Server 



Command Invoker 



Provides the ability to exchange certain 
information between HP VUE clients 

Provides the ability to invoke operating 
system commands on local and remote 
hosts. 
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Preliminary Configuration 



This chapter covers some of the preliminary configuration you must do before 
starting the X server and HP VUE. It includes: 



Using custom screen configurations. 
Configuring the system for special input devices. 
Using Native Language Support. 



Note Information in this chapter may not apply to all operating 

I systems. See the notes at the beginning of each topic discussion 

Wa for more information. 

There are two other chapters that deal with various aspects of initial 
configuration: 

■ Chapter 4 discusses how HP VUE provides for distributed operation. 

■ Chapter 5 covers the Login Manager, which is responsible for starting the X 
server, displaying the login screen, and validating the user. Multiple displays 
are configured by the Login Manager. 
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Using Custom Screen Configurations 

This section covers the default screen configuration and custom configurations 
for HP VUE. 

Note Information in this section is not applicable to Domain/ OS 

systems. 
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Default Configuration 

The default screen configuration for HP VUE is specified in 
/usr/lib/Xll/XOscreens. It assumes: 

■ There is one display — display 0. 

■ There is one screen — screen 0. 

■ The screen uses only one set of pixel planes (the image planes). 

■ The screen is at the address node specified by /dev/crt. 

If you use some configuration other than the default, you must edit the default 
screen file or add additional screen configuration files. 

There should be a separate X*screens file for each display, where * is a 
number that matches the display number used when starting the X server. 

Creating a Custom 'X*screens' File 

There are two ways to create a custom screen configuration for a display: 

■ You can modify XOscreens so that it contains device information for all the 
screen configurations you may want to use. This is generally the preferred 
way. Only one configuration is used at a time; the others are commented out. 
To switch from one screen configuration to another, you uncomment some 
lines and comment others. For multiple displays, you would have a separate 
file for each display — for example, Xlscreens for display 1. 

■ You can have a separate X*screens file for each screen configuration on a 
particular display. Switching between them involves modifying the command 
that starts the X server. 
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Screen modes and the syntax of the X*screens files is covered in the Using the 
X Window System manual. 

Running HP VUE in a Multiple Screen Environment 

HP VUE supports multiple screens in these ways: 

■ The HP VUE window manager can be started on multiple screens. 
Screen-specific resources can be specified for window manager resources. 

■ The session manager will save screen-related information about clients, 
and will restore clients to their proper screens at the beginning of the next 
session. 

Multiple screens are not supported by the following portions of HP VUE: 

■ Only one workspace manager is allowed per X server (display). It will be 
displayed on the default screen, or on the screen specified in the command 
line that starts vuewm (see "Using the Window Manager with Multiple 
Screens" in chapter 11). 

■ The session manager can run on only one screen. (However, it can save 
clients running on other screens.) 

■ The Broadcast Message Server and Command Invoker will run only on the 
screen running the session manager. This affects communication between 
clients, and may produce unpredictable behavior. For example, clients 
invoked from the file manager on screen 1 may display on screen 0. 

In general, HP VUE should be run on one screen only; use other screens for 
various non-HP VUE environments such as Starbase. 
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Making 'X*.hosts' Files for Special Configurations 

The X* .hosts files, if present, are used by HP VUE the first time HP VUE is 
run. The XO .hosts file contains a list of all remote hosts initially permitted 
to access your local server. The default screen configuration file XOscreens 
uses the default remote host file XO. hosts. Each custom X*screens file uses a 
corresponding X*. hosts file. 

The HP VUE Session Manager maintains a file, vug. settings, that saves and 
restores host information for sessions. Once this file exists (the user has logged 
in and out), the X* .hosts files are no longer used, and the user should use the 
Hosts dialog box in the style manager to edit the list of hosts. 

The X*. hosts file is covered in chapter 4. 



Using Special Input Devices 

HP VUE has an input device file that the X server reads to find out what 
input devices it should open and attach to the display. The default input 
device configuration file is /usr/lib/Xll/XOdevices. 

Customizing X*dGvices files is covered in the Using the X Window System 
manual. 



Running Starbase Applications 



Note This section does not apply to Domain/OS systems. 
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Allocating Colors for Starbase 

Starbase applications can create their own colormap. However, if a Starbase 
application uses the default colormap, then colors must be allocated to it 
before an HP VXJE session is run. The colors allocated to Starbase are not 
available to HP VUE. 

To allocate the Starbase colors, you must run the X client xinitcolormap 
before starting an HP VUE session. Do do this: 

1. Edit the file /usr/lib/Xll/vue/Vuelogin/Xsession to include a line 
that runs xinitcolormap. This file is a shell script that is run by the 
Login Manager right before it invokes the session manager. (The line is 
commented out in the default Xs ess ion file.) Use the -f option to specify 
the file containing the colors. 

2. Create the file containing the colors to be allocated to Starbase. 
Starbase applications do not communicate with the HP VUE color server. 

Environment Variables for Starbase Applications 

Most environment variables for Starbase applications can be set 
in .vueprof ile. However, two variables must be set before the X 
server is started — SB_DISP_ADDR and WMSHMSPC. Meaningful defaults 
are provided for these variables. If you must change them, use the 
vuelogin resource environment. The resource is added to the file 
/usr/lib/Xll/vue/Vuelogin/Xconf ig. 

For example, the following line specifies values for the two variables: 

Vuelogin*environment : SB_DISPLAY_ADDR=OxBOOOOO \ 

WMSHMSPC=0x200000 
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Customizing HP VUE for Native Language Support 

This section covers: 

■ How HP VUE sets the LANG environment variable and other environment 
variables. 

■ Accessing language-dependent message catalogs and resource files. 

■ Remote execution in systems on which Native Language Support (NLS) is 
available. 

Setting the LANG Environment Variable 

The LANG environment variable must be set in order for HP VUE to use native 
language support. Setting LANG causes HP VUE to use the operating system's 
language-sensitive routines for character handling. 

You can set LANG to any value supported by the operating system. The NLS 
directory /usr/lib/nls (/usr/nlslib on Domain/OS) contains an entry 
for each supported value. The HP VUE message catalogs are located in 
subdirectories of the NLS directory. 

There are three ways to set LANG for HP VUE: 

■ By a vuelogin resource in the Xresources file. 

■ From the Options menu in the login screen. 

■ In the .vueprof ile file. 

Table 3-1. Effects of Setting LANG Different Ways. 



Method 


Localized 
login screen? 


Effect on HP VUE Session 


vuelogin resource 


Yes 


LANG set for all users. 


Login screen Options menu 


Yes 


LAMG set for all users. 


.vueprolile file 


No 


LANG set for single user. 
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Setting the Language with a Vuelogin Resource 

Setting the language by means of a vuelogin resource has these effects: 

■ The vuelogin client reads the appropriate message catalog for that language 
and brings up the localized login screen. 

■ The LANG environment variable is set to that language for HP VUE 
sessions for all users. (LANG can be set for individual users by an entry in 
.vueprof ile.) 

■ The resource should set the NLSPATH environment variable appropriately for 
the chosen language. If this is not the case, or if you want to set NLSPATH 
yourself, see "Message Catalogs — the NLSPATH Environment Variable" later 
in this chapter. 

The resource is set by placing the following line in 
/usr/lib/Xll/vue/Vuelogin/Xconf ig: 

Vuelogin . host_ display . language : language 
For example, the following line sets LANG to Swedish on display hpcvxpae:0. 
Vuelogin. hpcvxpae.O. language: Swedish 

Setting LANG from the Options IVIenu 

Setting the lanugage from the login screen Options menu causes HP VUE to 
use that value of LANG for the next session. LANG returns to its default value at 
the conclusion of the session. 

Setting LANG in .vueprofiie 

User-specific environment variables for HP VUE sessions can be placed in the 
file $HOME/. vueprof ile. 

■ If you use sh or ksh: 

LkUG- language 
export LANG 

■ If you use csh: 

setenv LANG language 
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Other NLS Environment Variables 

This section covers other NLS environment variables. These variables are not 
affected by the vuelogin language resource nor by the login screen option 
menu. 

■ Set them in /usr/lib/Xll/vuG/Vuelogin/Xsession to set system-wide 
variables. 

■ Set them in $HOME/.vueprof ile for user-specific variables. 

In the following examples, %L is translated by the system into the value of the 
LANG variable; y,N is translated into the value of the application's class name. 

Message Catalogs— The NLSPATH Environment Variable 

The NLSPATH environment variable determines the paths applications search 
for NLS message catalogs. HP VUE clients place NLS message catalogs in 
the NLS directories /usr/lib/nls/$LANG (non-Domain/ OS systems) or 
/usr/nlslib (Domain/OS). Both LANG and NLSPATH must be set in order to 
use those message catalogs. 

The proper value of NLSPATH depends on whether message catalogs exist for the 
current value of LANG. 

■ To use the message catalogs for the language to which LANG is set, set 
NLSPATH to: 

/usr/lib/nls/y.L/y.N . cat : /usr/lib/nls/C/XN . cat : $NLSPATH 

■ If no message catalogs exist for the language to which LANG is set, set 
NLSPATH to: 

/usr/lib/nls/C/y,N . cat : $NLSPATH 

Setting Language-Depended App-Defauits 

The default location for the app-def aults for HP VUE and X clients is 
/usr/lib/Xll/y,L/app-def aults, where y,L is the the value of LANG. For 
example, if LANG is set to Swedish, then applications will look for their 
app-def aults in 

/usr/lib/Xll/swedish/ app-def aults. If LANG is not set, y.L 
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is ignored, and applications look for their app-def aults in 
/usr/lib/Xll/app-defaults. 

The XUSERFILESEARCHPATH environment variables provides the ability to 
change the location of app-def aults. For exaniple, if it were desirable to 
move app-def aults to /users, then XUSERFILESEARCHPATH could be set to 
/users/y,L/app-def aults. 

If you set XUSERFILESEARCHPATH in $HOME/.vueprof ile, the value applies 
to all HP VUE and X clients you run. Non-clients will not find their 
resource files unless you link or copy them into the directory specified by 
XUSERFILESEARCHPATH. 

For additional information about localized resources, refer to the discussions of 
the resource database in the Xt Intrinsics documentation. 

Setting the KBD_LANG Environment Variable 

Note The ability to support native language keyboards depends on 

I the operating system. None of the information in this section 

ffip applies to to Domain/OS systems. Other operating systems 

may not support character sets for Asian languages. 

HP VUE allows you to override the physical keyboard attached to the HP-HIL. 
For example, a US ASCII keyboard with KBD_LANG set to czech will behave like 
a Czech keyboard. 
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KBD.LANG can be set after the server has started. A convenient place for setting 
the variable system- wide is in /usr/lib/Xll/vue/Vuelogin/Xsession. The 
following lines set KBD^LANG appropriately for languages that require the 
keyboard to be remapped. Insert theses lines in Xsessions after the line 
export EDITOR LOGNAME MAIL TERM: 

if [ ! -z "$LAIG" ] 
then 

case $LAI6 in 

bulgarian I czech | hebrew | hvuigarian | \ 
Japanese I korean | polish I rumanian | \ 
russian | serbocroatian) 
KBD_LAI6=$LAI6 
export KBD_LAIG ; ; 
chinese-t) KBD_LAI6=t_chinese; ; 

export KBD.LAIG; ; 
chinese-s) KBD_LAI6=s_chlnese 
export BKD.LAIG; ; 

esac 
fi 

The NLIO processes for Asian users start only when either the physical 
keyboard is Asian or KBD_LANG is set to an Asian language. 

Language-Dependent Bitmaps— the XBMLANGPATH Variable 

The XBMLANGPATH variable specifies the search path for language- dependent 
bitmaps. It lists the paths for bitmaps in this order: 

1. User-specific bitmaps. 

2. System bitmaps listed in the XmGetPixmap(3x) man page. 

3. Append: 

/usr/lib/Xll/bitmaps/y.N/y.B 
This ensures that you will get the non-localized bitmaps, where necessary. 
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other Language-Dependent Resource Files 

When LANG is set, HP VUE uses the following language-dependent default 
resource files: 

■ /usr/lib/Xll/vue/Vuesession/'/,L/sys . session. 

■ /usr/lib/Xll/vue/Vuesession/y,L/sys .resources. 

■ /usr/lib/Xll/vue/Vuewm/y,L/sys . vuewmrc. 

Editing in HP VUE 

All characters that can be entered from an HP keyboard into a terminal 
emulator window can also be entered into HP VUE text entry areas. 

Remote Execution and NLS 

You can invoke localized HP VUE applications on any remote execution host 
that has a similarly- configured localized HP VUE installation. The values 
of the NLS-related environment variables on the host that is invoking the 
application are passed to the remote host when the application is started. 
However, the environment variables do not contain any host information. 
Thus, the message catalogs and application resource files must be in the same 
locations on both systems unless the $HOME/.softenv file on the remote host 
specifies the location of the files on the remote system. 
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Distributed Operation 



This chapter describes how to configure systems so that you can use HP VUE 
to run applications and access data in a distributed computing environment — 
that is, and environment where the application and/or data exist elsewhere 
than on the local workstation. 

Note This chapter does not apply to Domain/OS systems. For 

I information about distributed operation in HP VUE running 

flA on Domain/OS systems, see the HP Visual User Environment 

Configuration Guide for Domain 0/S Systems. 



Basic Concepts 

HP VUE supports several different types of distributed operations in addition 
to the standard X windows distributed display capabilities: 

■ HP VUE can run on one host and invoke applications on a remote host. 

■ HP VUE can run on one host and access files on a remote host. 

■ HP VUE can invoke applications on a remote execution host and supply the 
application with files from a different remote data host. 
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Thus, when an application is running under HP VUE, there can be up to four 
different hosts involved: 

■ The host running the X server. This is the host which displays all the user's 
activity. 

■ The host on which HP VUE is running — the local host. This is usually 
the same as the host running the X server. However, for X-terminal 
configurations, the two are different. 

■ The host where the application is running — the execution host. 

■ The machine where the data files are located — the data host. 



Accessing Remote Data 

This section covers: 

■ How to specify data files for HP VUE. 

■ How HP VUE accesses data files. 

■ How to configure the system for remote data access. 

Specifying Data Files 

In HP VUE, data files are specified by the syntax: 

[hostname: ] filename 

The hostname is optional when specifying a file located locally, but must be 
specified when the file is located on a remote host. For example, consider a 
user running an HP VUE session on host pronto. K double- clicking an action 
icon displays a prompt for a filename, you can specify the file /tmp/datal on 
pronto by entering either /tmp/datal or pronto: /tmp/datal. To specify 
a file on remote data host scribe, you must use the hostname qualifier 
scribe : /tmp/datal. 
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How HP VUE Accesses Files 

If you specify a data file without a hostname qualifier, the file is assumed 
to reside on the local host, and HP VUE accesses the file using the normal 
operating system procedure. 

Files that are specified with a hostname qualifier are translated into one of two 
forms: 

■ If the data host is local, the leading hostname : is stripped off. For example 
hpcvxba:/tmp/datal becomes /tmp/datal. 

■ If the data host is remote, hostname: is replaced with /nfs/ hostname/ . For 
example, hpcvxba: /tmp/datal becomes /nfs/hpcvxba/ tmp/datal. 

Configuring For Remote Data Access 

To allow applications on one host (the execution host) to access files on a 
remote data host, the execution host must NFS-mount the data host file 
system in the following manner: 

■ The mount point for the remote file system must be: 

/nf s / remote-hostname 

If the data host is in a different domain than the execution host, you 
must used the fully- qualified domain name of the data host (for example, 
pronto.dom.hp.com). Refer to the networking documentation for your 
operating system for more information about domain naming. 

■ The following remote files systems must be mounted: 

n Root (the / directory). 

n The authentication directory for the remote system. For HP-UX, the 
authentication directory is /tmp. 

It is recommended that all file systems on the remote data host be mounted. 

In addition, the system requires that files accessed by HP VUE have their file 
systems mounted. It is recommended that each user have the same user id on 
all machines accessed via NFS. 
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Data Access on Diskless Clusters 



Note This section applies only to operating systems that support 

diskless clusters. 
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The HP VUE remote file access mechanism works the same on clusters as it 
does on stand-alone systems, with the following exceptions: 

■ Only a cluster server can export its file system for NFS mounting. 

■ Context-dependent files must be given special consideration. 

Explicit Specification of Context-Dependent Files 

If a specific context-dependent file is needed, it can always be accessed using an 
explicit path (see the cdf (4) man page). For example specifying the context: 

server: /etc/inittab 

refers to inittab on the server machine. To access inittab for a particular 
node, specify: 

server: / etc/ ±nittab+/ node 

Accessing Systems in Remote Clusters 

When data is needed from remote clusters, the cluster server must be specified 
as the data host. Under this configuration, context-dependent files default to 
the version of the server. 

Accessing Remote Systems wittiin tlie Same Cluster 

HP VUE accesses files on all remote systems via NFS, including remote 
systems that are in the same cluster as the local host. In this case, 
context-dependent files default to the version for the server. 

It is also possible to access other systems within the same cluster so that 
context-dependent files default to the version of the execution host. Both of 
these approaches produce the same result unless a context-dependent file is 
present in the path to the specified file. 
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Defaulting to the Server's Context-Dependent Files 

If other machines in the same cluster are used as execution hosts, the cluster 
server should be a data host, and the server file system^ should be mounted on 
to itself. 

For example, the root directory of server should be NFS mounted on: 

server: /nfs/ server 

Defaulting to the Execution Host's Context-Dependent Files 

Within a cluster, a symbolic link can be used instead of NFS mounting the file 
system onto itself. In this configuration, context-dependent files are accessed 
uing the context of the execution host rather than the server. 

To create this symbolic link, execute: 

In — s / /nfs/server 

As an example of this configuration, suppose process! is executing on nodel, 
and process2 is executing on node2. In process 1 and process2: 

server: /etc/inittab 

refers to 5eruer/etc/inittab+/nodel, and 5€ruer/6tc/inittab+/node2, 
respectively. 



Remote Execution 

This section covers: 

■ HP VUE requirements for remote execution. 

■ Configuring HP VUE for remote execution. 

■ How to specify a remote execution host for an action in the action definition 
database. 

■ How the user's access rights are checked on the remote host. 

■ The environment under which remote applications are run. 
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Requirement for Access to a Remote Execution Host 

HP VUE provides a component called the Sub-Process Control Daemon (SPCD 
or softspcd) to support remote execution. This component is part of the 
Broadcast Message Server (BMS). The BMS must be installed on any host that 
is used as a remote execution host for HP VUE. 

When an HP VUE session on one host wishes to invoke an application on a 
remote host, HP VUE sends a message to the SPCD on the remote host that 
specifies the execution string for the application. 

The remote SPCD is invoked through the standard inetd process, which 
also must be installed and correctly configured on the remote host. Normal 
installation procedures correctly install and configure inetd. (See the 
inetd (Im) man page for more information). 

For security reasons, the SPCD does not allow root to perform remote 
execution; root can't perform the file-based authentication over NFS. 
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Configuring HP VUE for Remote Execution 

In order for an HP VUE session on one host to invoke applications on another 
host, the following conditions must be met: 

■ HP VUE must be correctly installed on the local host. 

■ Either all of HP VUE, or just the BMS hleset, must be installed on the 
remote execution host. 

■ Each host must have correctly configured hostname and network address 
specified in their /etc/hosts files. Alternatively, the operating system name 
server mechanism may be used. 

■ The /usr/adm/inetd.SGC file on the remote execution host must specify 
that the local host is allowed to connect to its SPCD service. This is 
accomplished by listing the local host using the syntax: 

spc allow . . . local-host . . . 

For more information about inetd.sec, see "Network Security" later in this 
chapter. 

■ The user must have a valid login (username and password) on both hosts. 
The user should have the same user-id (uid) on both systems. 

■ The remote execution host must be authorized to connect to the display on 
the local host. This authorization is implemented by: 

□ The /etc/X*. hosts file. 

□ The style manager Hosts dialog box. 

For more information about display access, see "Limiting Access to a Local 
Display" later in this chapter. 

■ If the application running on the remote execution host must access data files 
from the local host, then the application host must be configured for remote 
data access to the local host. (See "Configuring for Remote Data Access" in 
this chapter.) 

■ The local host must have NFS access to the / and /tmp directories of the 
remote host. These file systems must be mounted under /nfs/ remote-host 
and /nfs/ remote-host /tmp. 
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Access Rights on the Remote Execution Host 

When HP VUE runs a process on a remote execution host, the user's access 
rights on the remote machine are checked, and the user's current environment 
is transmitted to the remote process. 

To check access rights on the remote machine: 

■ A file is created on the remote system via NFS. 

■ The user id of the file owner is obtained. The remote process runs as this 
user id. 

■ The user id is used as an index into /etc/passwd to obtain initial settings 
for the HOME environmental variable for the remote process 

Environment for Processes Executing Remotely 

When the process is run, the environment of the parent process is modified 
before it is inherited by the child. For local processes (processes running on the 
same machine as the parent HP VUE application): 

1. The contents of the file /usr/softbench/config/softenv are read. Each 
variable in this file is put into the child environment. The variables in this 
file overwrite existing variables in the child environment. 

2. The environment created by Step 1 is modified by the contents of 
$HOME/ . sof tenv. A variable in . sof tenv overwrites any existing variables. 

In order to set environment variables for remote process execution: 

■ The environment is modified in exactly the same way on the local host as if 
it were a local process, with the variables specified in $HOME/ .sof tenv or 
/usr/softbench/config/softenv overriding current variables. 

■ The environment is transferred to the remote execution host. 

■ The environment is further modified according to the $HOME/. sof tenv or 
/usr/vue/conf ig/sof tenv files on the remote host. 

■ The DISPLAY environment variable is handled specially. If it is set to 
local: n, unix: n, or : n on the local system, it is translated to the 
appropriate value of hostname : n before being placed in the remote 
environment - 
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Domain Naming Environment Considerations 

In a domain naming environment, the host running HP VUE and the 
remote execution host must all reside in the same subdomain. These remote 
execution hosts within the local subdomain should be specified using a simple, 
unqualified nam^e. For example, if VUE is running on "pronto.dom.hp.com" 
and "indigo.dom.hp.com" is to be used as a remote execution host, it should be 
specified using the simple name "indigo". 

HP VUE is capable of accessing remote data hosts either within the local 
subdomain or in a separate domain. If the data host is within the local 
subdomain, it should be specified using the simple, unqualified name (for 
example, "indigo"). If the data host is in a separate domain, it must be 
specified using the fully qualified name (for example, "indigo.dom2.hp.com"). 
This fully- qualified name must be used for both the NFS mount and when 
specifying a file. 

Refer to the networking documentation for your operating system for more 
information about domain naming. 



Controlling Access and Security 

This section covers several aspects of system security: 

■ Network security used by the Broadcast Message Server (BMS). 

■ X Windows security for X servers and displays. 

■ NFS security for NFS-mounted files. 

■ Providing logins on remote hosts. 

■ Providing network transparency — access without formal login (.rhosts). 
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Network Security 

When HP VUE runs on a machine connected to a network, it should be 
configured to restrict access to only the work- group that requires it. 

The following two files provide mserve and spc security. 

Table 4-1. BMS Security Files. 



FUe 


Description 


/etc/services 


Lists all network services available through fixed port 
numbers. The spc service must be listed. 


/usr/adm/inetd . sec 


Lists systems for which BMS and Sub-process control 
services are provided. 



The mserve (Message Server) and spc (Sub-Process Control) services provided 
by HP VUE are automatically restricted in /usr/adm/inetd. sec by the 
customization script to: 

■ The host name of the system, if it is running stand-alone. (This applies to 
HP-UX 7.* systems only.). 

■ The nodes in the cluster, if it is a cluster system. On a diskless cluster, 
/usr/adm is a context-dependent directory. Thus, /usr/adm/inetd. sec is 
not shared automatically within the cluster. 

For example, this is the contents of inetd.sec on a cluster of three nodes after 
installation: 

mserve allow host A hostB hostC 
spc allow hostA hostB hostC 

To provide access from other machines, edit /usr/adm/inetd. sec manually by 
appending them to the end of the line. To add a complete network, include the 
network or subnet component of the address. For example: 

mserve allow hostA hostB hostC 192.6.36.* 
spc allow hostA hostB hostC 192.6.36.* 

You should keep the access list as small as possible, since these services allow 
access to the machine by anyone connecting to the port. 
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If a machine attempts to connect to the message server or spc without access 
permissions, an error message occurs. The error message may indicate a broken 
connection and suggest that you check inetd.sec. Since there are other 
reasons why a connection may break, the system cannot always identify a 
security problem. If the machine on which HP VUE is started does not have 
permission to connect to the message server, the session manager displays an 
error dialog box and exits. 

The host on which the environment is first started must always be listed 
in inGtd.sGc. If inetd.sec is shared via an NFS mount (this is not 
recommended), it would have to include all hosts which need to talk to any 
message server with access to the shared file. This is not handled automatically 
by the installation procedure. 

If you change the host name or internet address of the machine, make sure that 
inetd.sec contains the new host name. 

See the inetd.sec (4) man page for additional information. 

Limiting Access to a Local Display 

There are two basic schemes for limiting remote access to a local display. 

■ Authorization by host name. This is the default authorization system used 
by HP VUE. It involves maintaining a list of all the remote hosts that have 
permission to use the local server to display clients. Authorization by host 
name is implemented by: 

n The /etc/X*. hosts file, where * is the display (for example, XO. hosts for 
display 0). 

n The settings saved by the session manager and changed by the Hosts 
dialog box in the style manager. 

■ Authorization by user. This feature is provided by the R4 X server. 
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The 'X*.hosts' File 

When the server starts for the first time (there have been no previously stored 
sessions), it reads X*. hosts to obtain its list hosts. X*. hosts has the syntax: 

hostl 
host2 
hosts 

In general, XO. hosts should contain only those remote systems where you 
regularly run clients with windows redirected to the local display. If you use 
the R4 security mechanism, it is recommended that XO. hosts be empty. 

Once you are using the session manager to begin and end sessions, the 
XO. hosts file is no longer read. 

Saving and Editing Hosts with the Style l\/lanager 

The first time the user displays the style manager's Hosts dialog box, its list of 
hosts, obtained from the server, is the same as the contents of X*. hosts. Any 
modifications made there are saved at the end of the session and restored at 
the beginning of the next session. 

Refer to chapter 6 for more information on server settings saved by the session 
manager. 

NFS Security 

NFS security is provided by the file /etc/exports. It contains a list of the 
remote systems that are permitted to NFS-mount local disk volumes. For 
example, if /etc/exports on system hphere contains the entry: 

/doc hpthere 

then system hpthere can mount volume /doc located on system hphere. 
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Providing Access Without Login 

The $HOME/ .rhosts file provides access by remote systems to the local system 
using the local login account. Thus, the remote system does not need to 
provide a formal log in and password. 

The .rhosts file has the syntax: 

hostl iuser] 
host2 iuser] 
hosts iuser] 

If the user name is not included on the same line as the host name, the 
.rhosts file assumes that the remote user name is the same as the local user 
name. 

HP VUE does not directly use the .rhosts mechanism. 



Changing Your Hostname 

This section describes how to reconfigure the system if you change your host 
name after HP VUE has been installed. You might do this, for example, to 
change the host name from \mknown (the default) to some unique name so that 
you can connect the system to a network. 
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In addition to the normal operating system tasks, there are several files you 
may need to modify: 

■ You may need to modify the /usr/adm/inetd.sec security file. 

n If this file does not exist, or if it contains the following lines: 

mservG allow 
spc allow 

then all hosts are authorized to connect to your local host. In this case 
changing your host name will not cause any problems. 

n If your system uses /usr/adm/inetd.sec to enforce security by listing 
specific hosts that are allowed, then the entry for your local host must be 
changed to your new host name. For example, if you change the name of 
your host from oldname to newname, then you must alter lines of the form: 

mserve allow oldname host2 . . . 
spc allow oldname host2 . . . 

by replacing oldname with newname. 

■ In cluster systems, you must modify all the context-dependent 
files in the /usr/lib/Xll/vue directory. This includes the 
/usr/lib/Xll/vue/Vuelogin/Xservers files. 
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Setting Up Logins on a Remote Host 

For a local system to access a remote host: 

■ The address and hostname of the remote host must be listed in the local 
system.'s /etc/hosts file. 

■ The user must have a valid login (username and password) and home 
directory on the remote host. 

To set up a login on a remote host: 

■ Ensure that the remote host has a valid internet address and hostname in the 
local/ etc/hosts file. 

■ Provide a username, password (if necessary), and a home directory on the 
remote system. 

If your system uses the Name Server, the /etc/hosts entry may not be 
necessary. Refer to the networking documentation for your operating system 
for more information. 



Using HP VUE With Yellow Pages 

If you are using Yellow Pages for a hostname server, the Yellow Pages server's 
database must contain the name of the hosts that are running HP VUE. 
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The Login Manager 



The login manager is the term used to describe the portion of HP VUE 
responsible for: 

■ Reading initial configuration files. 

■ Starting the X server. 

■ Displaying the login screen and validating the login and password supplied by 
the user. 

■ Invoking the HP VUE session manager. 
This chapter covers: 

■ The files used by the login manager. 

■ How the login manager obtains environment variables. 

■ Customizing the appearance and behavior of the login screen. 

■ How the login manager provides for multiple-display configurations. 

■ How to configure HP VUE for various special environments: 
n Operation without the X server (non- window operation). 
n Foreign servers (X terminals). 

□ HP-UX cluster systems. 
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Login Manager Files 

This section covers the files used by the login manager. 



The Login Manager Clients 

The functionality of the login manager is provided by three HP VUE clients, 
located in directory /usr/lib/Xll/vue/etc. 

Table 5-1. The Login Manager Clients. 



Client 


Description 


vuelogin 


Performs configuration tasks and spawns another vuelogin 
process for each display in the system. Thus, there will be n+1 
vuelogin clients running, where n is the number of displays 
managed by the system. 


vuegreet 


Provides the functionality of the login screen. 


vuehello 


Provides a transition effect between successful login and the 
beginning of the HP VUE session. By default, this is a welcome 
message and copyright notice. 



Other Configuration Files 

This section describes the configuration files used by the login manager. 

Configuration Files That Boot HP VUE 

The configuration files that boot HP VUE depend on the operating system. 
Refer to the HP Visual User Environment Configuration Guide for your 
operating system for additional information. 
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Files in tlie Vuelogin Directory 

The following login manager files provide system configuration information. 
They are located in /usr/lib/Xll/vue/Vuelogin. 

Table 5-2. Login Manager Files in /usr/lib/X1 1/vue/Viielogin. 



File Name 


Description 


Xconf ig 


Contains the resources for the behavior of vuelogin. It can also 
define new locations for the other vuelogin configuration files. 


Xerrors 


Contains error messages from vuelogin and other programs 
run during session initiation. 


Xpid 


Contains the process id of the parent vuelogin process. 


Xservers 


Contains a list of servers to be run by vuelogin. 


Xresources 


Contains resources for the appearance of the login screen. 


Xstartup 


Program (usually a shell script) that is run as root after the 
user login and password is validated. 


Xsession 


Shell script that sets up the user environment variables, runs 
vuehello, and invokes the session manager. 


Xreset 


Shell script that is run as root upon termination of an HP VUE 
session. It can be used to return the system to its pre-Xstaurtup 
configuration. 



On an HP-UX diskless cluster, the Vuelogin directory is context-dependent. 

On Domain/OS systems, the Vuelogin directory is a link to 'node.data (or to 
' node _da.t a. node-id for diskless clusters.) 
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User-Specific Files 

The following files provide default configurations that are user-specific. 

Table 5-3. Login Manager Files in $HOME. 



File Name 


Description 


.Xauthority 


Contains authorization information needed by clients that 
require an authorization mechanism to connect to the server. 


.vueprolile 


Contains environment variables. 



How the Login Manager Works 

The login manager executable (vuelogin) is started during the system boot 
sequence. 

1. vuelogin reads the configuration file Xconf ig in 
/usr/lib/Xll/vue/Vuelogin. Xconf ig contains resources for 
various login manager actions. 

2. vuelogin reads the following files in /usr/lib/Xll/vue/Vuelogin: 

■ Xservers, or the file identified by the resource Vuelogin. servers in the 
Xconf ig file. 

■ Xresources, or the file identified by the Vuelogin*resources resource in 
the Xconf ig file. 

3. The parent vuelogin starts the X server for each local display. 

4. The parent vuelogin starts another vuelogin process for each managed 
display. 
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The following steps happen for each vuelogin started by the parent vuelogin: 

1. vuelogin invokes vuegreet, which displays the login screen and handles the 
user's interaction with the login screen. 

2. Once the user login and password have been validated, vuelogin runs 
Xstartup. 

3. vuelogin sets certain environment variables to default values. (See "Setting 
Environment Variables" later in this chapter.) 

4. vuelogin then runs Xsession, which performs several operations: 

■ It runs vuehello, which displays the message of the day or some other 
transition effect. 

■ It reads $HOME/.vueprof ile, which may contain additional environment 
variables or variables that override those set automatically by vuelogin. 

5. vuelogin invokes the session manager, vuesession. 

When the user terminates a session, the login manager runs Xreset. 
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Figure 5-1. Login l\/lanager Operations. 
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starting HP VUE 

The procedure for starting (booting) HP VUE depends on the operating 
system on which it will be running. Booting HP VUE is covered in the HP 
Visual User Environment Configuration Guide. 



Customizing Startup Behavior 

It may be necessary for the system to perform certain tasks for the user — for 
example mounting the user's file system — before invoking the session manager. 
The /usr/lib/Xll/vue/Vuelogin/Xstartup file provides this capability. 
Usually, Xstartup will be a shell script. It is run as root after the user has 
been authenticated, before the session manager is started. 

The following environment variables are set to the specified values for the 
duration of Xstartup: 

Variable Value for Xstartup 

DISPLAY Display name. 

USER User name. 

HOME Home directory of the user. 

PATH Value of the systemPath resource in Xconf ig. 

SHELL Value of the systemShell resource in Xconf ig. 

XAUTHORITY May be set to an authority file. 

TZ Set to the current time zone. 

You can use Xreset to undo tasks done by Xstartup. 
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Setting Environment Variables 

This section covers: 

■ How HP VUE obtains environment variables. 

■ How to set additional variables for the HP VUE environment. 

■ How to provide for executing additional shell commands for a non-HP VUE 
environment. 

How HP VUE Obtains Environment Variables 

Since HP VUE runs the X server before the user has logged in, the 
functionality provided in Xll by bin/login and .profile or .login must be 
provided instead by vuelogin. 

Caution When a user logs in to HP VUE, the .profile (or .login) file 

is not read. 



• 
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The login manager obtains environment variables as follows: 

■ Certain environment variables are built into vuelogin. These are set 
separately for each display after the user login and password have been 
validated. For a list of these variables, see the HP Visual User Environment 
Configuration Guide. 

■ System-wide variables are set in /usr/lib/Xll/vue/Vuelogin/Xconf ig 
or /usr/lib/Xll/vue/Vuelogin/Xsession. See "Setting System- Wide 
Environment Variables" in this chapter for more information. 

■ Additional user environment variables can be placed in $HOME/.vueprofile. 
This file can also be used to override system-wide variable settings. This file 
should contain only variable settings; it cannot contain shell commands that 
require terminal I/O or that run in the foreground. See "Setting Personal 
Environment Variables" later in this chapter. 
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Figure 5-2. How HP VUE Obtains Environment Variables. 
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Setting System-Wide Environment Variables 

System-wide environment variables can be specified in the following locations: 

■ /usr/lib/Xll/vue/VuGlogin/Xconf ig. Variables set here will be available 
both to the HP VUE session and to the X server. 

■ /usr/lib/Xll/vue/Vuelogin/Xsession. Variables set here are available 
only to the HP VUE session. 

Setting Variables in 'Xconfig' 

Variables set in /usr/Xll/lib/vue/VuGlogin/Xconf ig are available both to 
the HP VUE session and to the X server. If the X server does not use the 
variable, it will be applied only to the HP VUE session. 

There is no shell processing within Xconf ig. Variables except TZ and LANG are 
set using the Gnvironment resource. Variables can be set for all displays or on 
a per- display basis. 

The syntax for specifying environment variables in Xconf ig is: 

Vuelogin* [ host_ display . ] environment : vanable= value 

To set more than one variable, separate each assignment with a space or tab. 
The values assigned to the variables must be constants, since the resource does 
not use a shell to interpret the value. 

For example, the following lines set variables. EDITOR will be available for all 
displays. SB_DISPLAY_ADDR is available only to hpcvhere: 1. 

Vuelogiii*enviroiiiiient : EDITOR=vi All displays. 

Vuelogin*hpcvhere_l . environment : EDITOR=vi \ Display hpcvhere:!. 

SB_DISPLAY_ADDR=OiBOOOOO 

The TZ and LANG variables have dedicated resources. For example, the 
following line in Xconf ig sets the time zone for all displays: 

Vuelogin*timeZone: PST8PDT 

See "Setting the Time Zone" later in this chapter for more information about 
TZ. 
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Setting Variables in 'Xsession' 

Variables set in /usr/Xll/lib/vue/Vuelogin/Xsession are applied to the 
HP VUE session, but not to the Xserver. Xs ess ion is a shell script, so shell 
processing is available. For example, the following line is acceptable syntax for 
setting MAIL. 

MAIL=/usr/mail/$USER 

To apply variables on a per-display basis, use a separate "Xsession" file for 
each display, and specify the individual files in Xconf ig. For example, the 
following line in Xconf ig specifies the session file for display hpcvhere: 1: 

Vuelogin*hpcvhere_l . session : /usr/lib/Xll/vue/Vuelogin/Xsession. hpcvhere 

Setting Personal Environment Variables 

User-specific environment variables are set in $HOME/.vueprof ile. 

Creating a '.vueprofile' File 

A $HOME/.vueprof ile file is created, if it does not already exist, the first time 
you log in to HP VUE. However, should you need to create the file yourself, 
follow this procedure: 

1. Copy the template /usr/lib/Xll/vue/sys.vueprofile to 
$HOME/.vueprof ile. Give the new file write permission. 

2. If you want the file interpreted according to a shell other than the default 
shell, specify the shell for the file by placing #!/bin/sh, #!/bin/csh, or 
#!/bin/ksh at the top of the file. 

3. Add all the environment variables you want for your HP VUE environment. 

Note The .vueprof ile file should contain only lines that set 

I environment variables. It must not contain commands that do 

« terminal I/O, "tset", "stty", etc. 
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Setting Environment Variables in '.vueprofile' 

The .vueprof ile file should contain only variable settings; it should contain 
neither shell commands that require terminal I/O nor commands that run in 
the foreground. 

Caution When a user logs in to HP VUE, the .profile or .login file is 

not automatically read. 



• 



Set only environment variables in .vueprof ile. Commands 
like those for terminal input or output will corrupt your session 
environment. 



Using an Existing Sheil Environment Fiie with '.vueprofile' 

If you have an existing shell environment file (.profile or .login), you can 
continue to use that file by doing the following: 

1. Add lines to the end of .vueprof ile to source in the shell environment file. 

For ksh: 

VUE^true; export VUE 
$HOME/. prof ile 

For csh: 

setenv VUE true 

source $HOME/. vueprof ile 
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Edit the shell environment file to provide two sections. One section contains 
commands that do not apply to HP VUE (for example, commands that 
require terminal I/O, or variables for which yon want to replicate the HP 
VUE default values). The other section contains variables that apply, 
whether or not HP VUE is run: 

For example, for ksh: 

if C ! "$VUE" ]; then 

stty options 

tset options 

DISPLAY-i;a/«c 

MAIL=va/we 

export DISPLAY MAIL 

Additional shell commands that do not apply to HP VUE 

Additional variable assignments that do not apply to HP VUE 
fi 

PATH=t;a/wc 
Assignments for common variables 

For csh: 

if ( ! "$VUE" ) then 

stty options 

tset options 

setenv DISPLAY value 

set mail = value 

Additional shell commands that do not apply to HP VUE 

Additional variable assignments that do not apply to HP VUE 
endif 

setenv PATH value 
Assignments for common variables 



The Login Manager 5-13 



Setting the Time Zone (TZ) Environment Variable 

HP VUE obtains the value of the TZ environment variable from the following 
sources: 

■ An operating system file may define a default value. 

■ The timeZone resource in /usr/lib/Xll/vue/Vuelogin/Xconf ig. It has the 
syntax: 

Vuelogin*timeZone : value 
You can use the resource to override the value set by the operating system. 

■ $HOME/.vueprof ile. Values set here override system- wide values. 

The Display Environment Variable 

The DISPLAY environment variable sets the host, display number, and screen 
number to which a system sends bitmapped output for clients. 

The default value of DISPLAY is set automatically by vuelogin to hostname :0, 
which is display 0, screen of the local display. If you must change it, edit the 
first field of the appropriate entry in the Xservers file. (The HP-UX shmlink 
specification for the DISPLAY variable is not supported by HP VUE.) 

Most clients have a -display option for specifying a different host, display 
number, and screen number on which the client should display its output. 

Setting Additional Shell Commands 

If vuelogin is not executed (for example, you run a pure Xll environment or 
you log into an HP VUE system from a remote terminal), you may need to 
execute shell commands. Shell commands should be placed in .profile or 
. login. 
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Customizing the Login Screen Appearance 

To change the appearance of the login screen, you must edit resources in 
/usr/lib/Xll/vue/Vuelogin/Xresources or in the file specified by the 
resource Vuelogin. Display .resources in the Xconf ig file. 

Changing the Login Screen Logo 

The syntax for logo resources is: 

Vvielogiii*logo* resource : value 
For example, the following line specifies a different bitmap for the logo: 

Vuelogi]i*logo*bitmapFile : /usr/lib/Xll/bitmaps/Vuelogin/HYlogo .bm 

For additional logo resources, refer to the vueloginClx) man page. 

Other Appearance Resources 

The Xresources file contains additional information about resources for 
changing the appearance of the login screen. 



Login IVIanager Errors 

If the login manger seems to not be working properly, you should check to see 
whether an error has been generated. Login manager errors are stored in the 
file /usr/lib/Xll/vue/Vuelogin/Xerrors. This includes errors produced by: 

■ vuelogin. 

■ Any standard error output by Xstartup, Xsession, or Xreset. 



The Login Manager 5-15 



Message of the Day 

The vuehello client provides the ability to display a message of the day. It 
displays a transition window after the user login and password are validated, 
before the session manager is run. 

By default, vuehello displays Starting the HP Visual User Environment and 
the copyright message (/etc/copyright) in the transition window. To add 
additional messages, use the -file option on the command line in Xsession 
that starts vuehello. Up to five files can be added; each uses a separate -file 
option. For example, the following line adds the general message of the day 
and a user-specified message. 

/usr/lib/Xll/vue/etc/vuehello -file /etc/motd \ 
-file $H0ME/m3rniessage 



Running HP VUE on Non-Console and Multiple Displays 

Note This section applies to operating systems in which the Xll 

Window System supports multiple displays. 



4 



The following two vuelogin files must be edited if you want to run HP VUE 
on one or more non- console displays. 

■ /usr/lib/Xll/vue/Vuelogin/Xservers. Xservers is responsible for 
starting the server on each display. There must be an entry in Xservers for 
each server to be started. 

■ /usr/lib/Xll/vue/Vuelogin/Xconf ig. Xconf ig contains resources 
necessary for invoking No Windows Mode on a display. The resources specify 
characteristics of the ITE associated with each display. Xconf ig can also be 
used to specify resources for each server started. 

In HP-UX systems, you may also need to edit /etc/inittab. See the HP VUE 
Configuration Guide for HP- UX Systems for more information. 
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Editing 'Xservers' for i\/iultiple Displays 

The file /usr/lib/Xll/vue/Vuelogin/Xservers starts the X server on 
each display running HP VUE. The default Xservers file assumes that HP 
VUE will run on one display — the system console. If HP VUE will be run on 
displays other than the system console, you must edit Xservers to start the 
server on each of those displays. 

Xservers contains a line for each server. The syntax for specifying a server is: 

DisplayName DisplayClass DisplayType Command 

DisplayName $DISPLAY. The display name that is passed to X programs by 
the -display option. It is used in display-specific resources to 
specify a particular display. The default is hostname lO. 

DisplayClass Used in setting display-specific resources for a particular class 
of displays. 

DisplayType There are two display types: 

local The local display running the server. 

foreign A remote display. Remote displays usually are 

X terminals that run sessions from a file server. 

Command The command line to start the server (for local servers only). 

For remote displays, the Command entry is ignored. 

For example, the following entries in Xservers start the server 
/usr/bin/Xll/X on three local displays running HP VUE on host hpcvaaa. 

hpcvaaa:0 Local local /usr/bin/Xll/X :0 
hpcvaaa:! Local local /usr/bin/Xll/X :1 
hpcvaaa:2 Local local /usr/bin/Xll/X :2 

The hostname can be a simple host name (for example, hpcvaaa) or a fully 
qualified domain name (for example, hpcvaaa.cv.hp.com). 
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Editing 'Xconfig' For Multiple Displays 

In a system with multiple displays, the file 
/usr/lib/Xll/vue/Vuelogin/Xconf ig is used: 

■ To specify different session initiation resources for different displays. 

■ To specify a file other that Xservers 

■ To configure No Windows mode for HP-UX systems running HP VUE. 

Using Different Resources for Different Servers 

The Xconf ig file can contain resources for customizing session initiation for 
different displays. The general syntax for these resources is: 

f host_ display 1 _, 

Vuelogin.< ,. , , ? .resource: filename 
[ display -class J 

The files specified by filename are used by the login manager for the specified 
host '.display or display ^class. 

The following table lists some of the resources that provide display-dependent 
session initiation. Refer to the vuelogin(lx) man page for additional 
information. 

Table 5-4. Display-Dependent Resources for Session Initiation. 



Resource 


Description 


startup 


Specifies the file run as root after valid login and password. 


resources 


Specifies the name of the file to be loaded as the resource 
database for the login screen. 


xrdb 


The program used to load resources. 
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For example, the following lines specify that separate files are used for two 
servers. 

VuGlogin.hpcvxpae.O. resources: \ 

/usr/lib/Xll/vue/Vuelogin/Xservers 
Vuelogin.hpcvxpae.l. resources: \ 

/usr/lib/Xll/vue/Vuelogin/Xserversl 
Vuelogin.hpcvxpae.O. startup: \ 

/usr/lib/Xll/vue/Vuelogin/Xstartup 
Vuelog in. hpcvxpae_l, startup: \ 

/usr/lib/Xll/vue/Vuelogin/Xstaxtupl 

Specifying a Different File for Starting Servers 

You can use the resource Vuelogin. servers to specify a different 
file for starting the server(s). The resource is entered into the file 
/usr/lib/Xll/vue/Vuelogin/Xconf ig. 

Vuelogin. servers can take as its value one of the following: 

■ A single server local to the host. 

■ The absolute path of a file containing a list of local servers. 

The default value for Vuelogin. servers is 
/usr/lib/Xll/vue/vuelogin/Xservers. 

Configuring No Windows Mode for l\/iultiple Displays 

Not6 No Windows mode is not available on Domain/ OS systems. 

J 



The login manager provides No Windows mode for workstations that are 
occasionally used for non-X applications that cannot run simultaneously with 
X. No Windows mode is invoked by selecting No Windows from the option 
menu in the login screen. 

No Windows mode suspends the server and runs a standard login sequence 
(getty /login). When the user finishes and logs out, the server is restarted and 
the vuelogin screen is redisplayed. 
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In order for No Windows mode to run properly on a display: 

■ The Xservers file must specify that the display is type local. 

■ The Xconf ig file must specify the display's associated ITE device file and 
speed. 

Two resources in Xconf ig are passed to the /etc/getty process to indicate the 
desired device and speed for the login sequence. 

Table 5-5. getty Resources. 



Resource 


Description 


gettyLine 


The device file for the login sequence. The default is 
console. 


gettySpeed 


An entry from /etc/gettydef s. The default is console. 



Each display must have a different value for gettyLine. 

For example, the following lines configure No Windows mode for non-console 
displays named hpcvaaail (associated with device /dev/ttyil) and 
hpcvaaa:2 (associated with device /dev/ttyi2). The line speed is 9600. 

Vuelogin*hpcvaaa_l. gettyLine: ttyil 
Vuelogin*hpcvaaa_ 1 . gettySpeed : 9600 
Vuelogin*hpcvaaa_2 . gettyLine : tty 12 
Vuelogin*hpcvaaa_2 . gettySpeed : 9600 

Note If there are more displays on the system than the number of 

I available ITE's, not all the displays will be able to operate in 

^B No Windows mode. 

For operating system releases prior to 8.07 only: Every display 
on the system must contain a unique gettyLine specification in 
the Xconf ig file; displays without ITE's must use a "dummy" 
gettyLine value. 
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X-Terminals 



NotG This section applies only to operating systems that support 

X- terminals. 



4 



An X-terminal system consists of a display, keyboard, and mouse that runs 
only the X server; clients, including HP VUE, are run on one or more "host" 
systems on the networks. Output from the clients is directed to the X-terminal 
display. 

Terminals Supporting XDMCP 

XDMCP (X Display Manager Command Protocol) provides a mechanism by 
which X- terminals can request login services from a network host. It ensures 
that the X-terminal is communicating with a valid login manager, and provides 
the protocol for exchanging authentication information between the X-terminal 
and the host login manager. 

If the terminal supports XDMCP, use the terminal's mechanism to request 
service from the host system running HP VUE. 

Non-XDMCP Terminals 

When HP VUE runs as a file server for a collection of non-XDMCP X 
terminals, edit the Xservers file to include an entry for each terminal. The 
displayType of each terminal must be foreign. For example, the following lines 
in Xservers directs vuelogin to manage sessions on three terminals. 

extl:0 HP700X foreign 
ext2:0 NCD-19 foreign 
ext3;0 NCR-TOWERVIEW3000 foreign 
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vuelogin will respond to two signals for the terminals: 

■ When it receives a SIGHUP, it rereads Xconf ig and the Xservers file (or the 
file specified by the Vuelogin. servers resource). If it finds a new entry, 
vuelogin starts managing that display. If an entry has been removed, the 
process associated with that entry is immediately terminated. 

■ When it receives a SIGTERM, vuelogin terminates all sessions in progress. 



Cluster Systems 

Configuring diskless clusters for HP-UX and Domain/OS systems is covered in 
the HP Visual User Environment Configuration Guide for those systems. 



stopping HP VUE 



Note This section applies to HP-UX systems only. For other 

I operating systems, refer to the HP Visual User Environment 

^n Configuration Guide for your operating system. 



To Stop HP VUE: 

1. Log out. 

2. Use the Options menu on the login screen to enter No Windows mode. 

3. Log in as root. 

4. Switch to a run level that does not run HP VUE by executing: 

/etc/telinit n-, exit 

where n is a run level for which /etc/inittab specifies a terminal or 
console. 

You can now log in again. 
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Shutting Down the Workstation 



Note This section applies to HP-UX systems only. For other 

I operating systems, refer to the HP Visual User Environment 

^n Configuration Guide for your operating system. 



To shut down a workstation running HP VUE: 

1. Stop HP VUE. See "Stopping HP VUE," above. 

2. Log in as root. 

3. Change to the root directory. 

4. Execute the appropriate shutdown command for your system. Refer to the 
owner's manual for your system for additional information. 

5. Reboot your workstation. 
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The Session Manager 



This chapter covers: 

■ The concept of an HP VUE session and the session manager. 

■ The files read and written to during a session. 

■ Customizing various aspects of the session manager 



Introduction to HP VUE Sessions 

An HP VUE session starts when the user successfully logs in and ends when 
the user exits the session and returns to the login screen. The HP VUE Session 
Manager is responsible for a number of housekeeping tasks associated with 
managing an HP VUE session: 

■ It starts the Broadcast Message Server (BMS), window manager and other 
clients. 

■ It maintains a database of files that saves session attributes so that the user 
can return to known states upon login. 

■ It selects the appropriate database files to use for starting a session, based 
on whether the user has chosen to return to the current (previous) or home 
session. 
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Names and Locations of Session l\/lanager Files 

This section covers the files that constitute the session manager and the session 
manager database. 

Session Manager Executable 

The session manager is implemented by the client vuesession, which is 
responsible for loading the appropriate resources, restoring server settings, and 
starting the clients. It is located in directory /usr/lib/Xll/vue/etc. 

Current and Home Session Databases 

The session manager database has two major parts: 

■ The current session database reflects the status of the system at the time the 
user logs out. This allows the session manager to return to the same state 
upon login if the user has chosen to do so. 

■ The home session database is a snapshot of the system explicitly taken by 
the user in the style manager. This database allows the user to store away a 
known state that he can return to later. 

Each display on which the session manager runs has two directories containing 
the session management current and home databases: 

Current database: $HOME/ . vue/host : display /cMTTent. 

Home database: $HOME/ . -vne/host : display /home. 

where host is the host on which the session is being displayed. 

For example, if a session is running on display of host 
hpcvhere, the directories $H0ME/.vue/hpcvhere:O/current and 
$HOME/.vuG/hpcvhere:0/home contain the session manager files. 
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Session Database Files 

The session manager creates and uses the following files in the session manager 
database directories. 

Table 6-1. Files Comprising the Current and Home Database. 



File 


Purpose 


vue. session 


Stores the names of active clients, their window 
geometries, their workspace presence status (which 
workspaces they are in, their state (normalized or 
minimized), and startup string. 


vue. resources 


Stores the resources for the active clients (including the 
window manager) in the session. 


vue. settings 


Stores the server settings and session manager settings. 



The following files are used when no current or home directories exist. They 
are located in directory /usr/lib/Xll/vue/Vuesession: 

■ sys. session stores the user default startup script. 

■ sys. resources stores the user default resources. 
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Session Startup 

When vuGsession executes, it performs the following operations: 

1. It starts the Broadcast Message Server, which is responsible for coordinating 
communication between the various HP VUE components. 

2. It searches for the existence of a session manager database directory: 

a. First, it searches for the $UOViE/ .-vne/hostidisplay/cuTTent directory. 
This directory exists if the user chose, at the end of the previous session, 
to return to that state at next login. 

b. If the $liOKE/ .vuq/ host: display /cuTxent doesn't exist, it looks for the 
^YiOViE/ ,v\iQ/host:display /home directory. This directory exists if the user 
has saved a home session in the style manager Startup dialog box. 

c. If neither of these directories is found, the session manager 
will use sys. session and sys. resources in directory 
/usr/lib/Xll/vue/Vuesession. 

3. When it finds the appropriate directory, it uses the vug . resources (or 
sys. resources) file in that directory to pass the resource values to the 
resource database manager (xrdb). 

4. It reads the accompanying vue. settings file. 

5. It then starts the window manager (vuewm). 

6. It reads the vue. session file and starts the clients listed in that file. 

7. It runs the optional sessionGtc script. 
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start Broadcast 
Message Server 



Load resources 



Read server 
settings 



Start window 
manager 



Run vue. session 



$HOME/ . vue/ <host>: <display>/current/vue. resources or 
$HOME/ . vue/<host> : <display>/home/ . vue . resources or 
/usr/ 1 ib/Xi 1 /vue/Vuesess ion/sys . resources 



$HOME/ . vue/ <hos t > : <d i sp 1 ay >/ cur r ent / vue . s et t ings 
$HOME/ .vue/ <host>: <display>/home/vue. settings 



vuewm or 
wmStartupCommand value 



$HOME/, vue/ <host>:<display>/current/vue, session or 
$HOME/ .vue/ <host>: <display>/home/vue. session or 
/usr/ 1 ib/Xl 1 /vue/Vuesess ion/sys . sess ion 



Run sessionetc 



Figure 6-1. How the Session l\/lanager Starts a Session. 



Changing Resource Settings During a Session 

Since the session manager maintains its own resource files for current and home 
sessions, there is no single file that can be used to add, delete, and modify 
resources. In general, it is unwise to write to the vue. resource files, since 
these are overwritten by user actions (logout or storing a home session). 

The best way to modify resources uses xrdb to merge new resources into the 
resource database. Managing resources is covered in chapter 8. 
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starting a Session With a Different Window l\/lanager 

The window manager (vuewm) is automatically started by vuesession. 
However, there may be configurations that require you to start a different 
window manager. 

The wmStartup command resource allows you to specify a different window 
manager. It takes as its value the executable command for starting the 
alternate window manager. For example, if the resource file contains the line: 

vuGsession*wmStartupCommand: /usr/bin/Xll/mwm 

then vuesession starts the mwm window manager instead of vuewm. 



Customizing Session Startup 

In general, the session manager will take care of starting clients at the 
beginning of each session. 

If desired, however, there are several ways to customize session startup: 

■ To customize the first session, edit the files sys. session and sys. resources 
in /usr/lib/Xll/vue/VuGsession/sys. session. 

■ If you need to execute X commands for processes or settings that 
are not saved by the session manager, create the shell script file 
$ilOVE/ .v\ib/ host '.display /sessionetc. When this file exists, the session 
manager runs it after it starts the clients listed in vue. session. 

For example, suppose you want to use xsetroot to customize the root 
(workspace) cursor at startup. You can do this by adding the following line to 
sessionetc: 

xsetroot -cursor /usr/include/Xll/bitmaps/pointer \ 

/usr/include/Xll/bitmaps/po inter. mask -fg black -bg red 

Processes that run indefinitely must be run in the background. 
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Customizing the Display Lock 

The default workspace manager includes the lock control for locking the 
display. When the display is locked, it ignores all keyboard and mouse actions 
until the user enters the password to unlock the display. 

The session manager provides three resources for customizing the display lock. 
Table 6-2. Display Lock Resources. 



Resource 


Description 


coverScreen 


When "True," , covers the locked display. 


alarmTime 


Sets the number of seconds the lock message dialog box is 
displayed. 


keys 


Specifies the users who can unlock the display with their 
passwords. The default is the login user and root. 



For example, the following lines specify that a locked screen is covered and 
that the login message is displayed for 30 seconds whenever the system detects 
keyboard or mouse activity. Users kreta, charlie, dex, and anna can unlock the 
screen with their passwords. (Root can also unlock the display). 



vuesession+coverScreen : 
vues ess ion* alarmTime : 
vuesession*keys : 



True 

30 

kreta , charlie , dex , anna 
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Error Logging 

Errors that occur during a session are written to the file 

$HOME/.vue/errorlog. This includes errors generated by vuesession, vuewm, 
and any other clients. 



When the Messaging Service Fails to Start 

If the session manager cannot start the BMS, it displays an error dialog box 
and exits back to the login screen. You must then use "No Windows" mode or 
a fail-safe session to correct the problem. Refer to "What to Do if the Session 
Manager Won't Start" at the end of this chapter for more information. 



Session Termination 

The action taken by the session manager when a user terminates a session 
depends on: 

■ Whether or not the user has requested that they want the current session 
restored. This determines how the session manager manages its database. 

■ The value of the queryServerSettings resource, which determines which 
settings are saved. 

Managing the Database at Session Termination 

If the current session will be restored, the session manager stores the current 
resource database, server settings, and client information in files in the 
^HOViE/ .vue/ host-.display / cuTTent directory. 

If the user has specified that the home session be used at next login, the 
session manager removes the $liOKE/ .v\iq/ hosUdisplay / cuTrent directory. 
When the user logs in again, the session manager will use the files in the 
$iiOKE/ .vue/ host -.display /home directory. 
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specifying Which Settings are Saved 

By default, the session manager saves only those server settings that are set in 
the style manager: 

■ Bell volume, pitch, and duration. 

■ Keyboard click Volume and autorepeat. 

■ Mouse acceleration and threshold. 

■ Screen saver time. 

■ Host information. 

■ Session startup information. 

However, the session manager resource queryServerSettings allows you to 
specify that additional server settings be saved. 

To save additional settings, set the resource to True by adding the following 
line to the resource file: 

vuesession*queryServerSettings : True 

Canceling a Session 

It may be necessary for you to cancel a session without using the norm.al HP 
VUE logout procedure. For example, this could happen if you made a mistake 
while trying to customize the window manager and workspace manager that 
deactivated both the logout button in the workspace manager and the Log 
out . . . button in the workspace menu. 

To cancel a session: 

■ HP-UX systems: Hold down (shift) and (ctrlI and press (Reset) ( (Shift) (ctrl) 



( Pause ) for HP C1429A Enhanced Vectra keyboards). The system will return 
to the login screen without saving your current session. Use the ps -f u login 
to make sure all hpterm processes are stopped. If any are still running, kill 
them using kill -9. 

Other systems: Use the ps command with the appropriate options to 
obtain the X server's process id. The process is associated with the 
line /usr/Xll/bin/server_name '.display. Then, use the apropriate kill 
command to halt the server. 
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Running Non-Standard Clients 

Certain non-standard clients may not be saved by the session manager. These 
clients are not restored when the user logs out and back in. 

The session manager file ^UOKE/ .vuq/ host '.display /sessionetc provides a way 
to execute these clients at the beginning of each session. Clients contained in 
this file will be started at the beginning of every session — both current and 
home sessions. 

Note Do not use sessionetc to start clients that are restored by the 

I session manager. Doing so causes the session manager to start 

Ki a growing number of processes, since a new process is started 

each time the user logs in. You may not immediately detect 
this because the windows are superimposed. 



IVIuitiple Screens 

In a multiple screen configuration, the session manager is able to restore clients 
to the screens on which they were running. 



What To Do if the Session l\/lanager Won't Start 

This section provides trouble- shooting procedures to use if the session manager 
fails to start because it cannot start the messaging service (the Broadcast 
Message Server or BMS). The symptom of this is that the system displays an 
error dialog box and exits back to the login screen. 

If the BMS fails to start, log into HP VUE using a fail-safe session and check 
your system: 

■ Make sure that the line that starts the server in 

/usr/lib/Xll/vue/Vuelogin/Xservers uses the actual host 
name. (The * in the first field of the command is also allowed.) 
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■ If you have previously used Softbench, and have used your own 
$HOME/.softinit file, you may need to remove it or edit it to include the 
HP VUE tools. Refer to chapter 15 for more information. 

■ The BMS requires the following files and cannot start if any of them are 
missing or lacks read permission: 

n In the /usr/softbench/bin directory: sof tmsgsrv sof tspcd, and 
softspcd.o. Series 800 systems running HP-UX 7.* also require 
sof tmsgsrv. o. Domain/OS systems also require softinit and 
softmerge. 

a A valid softinit file: either /usr/softbench/conf ig/softinit or 
$HOME/. softinit. Domain/OS systems also require softboot. 

Additional Considerations for HP-UX 7.* Systems 

These requirements apply only to HP-UX 7.* systems: 

■ If the workstation is configured as a solitary system (it is not networked to 
other systems), it must still be properly configured for networking in order 
for the BMS to start. This can be done by configuring your system to use 
the loopback address (127.0.0.1). Refer to chapter 1 of the HP Visual User 
Environment Installation Guide for procedures for configuring a solitary 
system. 

■ Verify that networking is properly configured: 

1. Execute the command: 

/etc/ping 'hostname' 

Use the literal string 'hostname' — do not substitute your actual host 
name. 

2. Interrupt this command after approximately 10 seconds (use (cTRLJ fcl, 

[del] , or (Break) ). 

3. You can proceed if the output shows a 0% packet loss under the line: 

hostname PING Statistics 

If this is not the case, see the configuration information in chapter 1 of the 
HP Visual User Environment Installation Guide and the troubleshooting 
sections in the Installing and Administering LAN/9000 manual. 
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The security file /usr/adm/inetd.sec must be properly configured to allow 
your system to connect to the BMS. Since the /usr/adm directory is a 
context-dependent file, you must check this file from the system experiencing 
the difficulties. 

Look for lines of the form: 

mserve allow hostl host2 
spc allow hostl host2 

These lines must specify the official name of your system (not an alias). It 
is best to use the short form of the host name (for example, hpcvlx) rather 
than the long form (hpcvlx . cv . hp . com). 

This file must be readable by all users. 

The file /usr/softbench/conf ig/softtypesZ/angrwafife must exist. If 
necessary, see "Localization Issues" in the HP Visual User Environment 
Installation Guide for more information. 
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Running Programs Using Command Lines 

The terminal emulator (hpterm or xterm) gives you access to a command line 
and shell. You can use the command lines to start applications and to execute 
operating system commands. 



Syntax for Starting Local Clients 

The general syntax for the command line that starts a client is: 

client [-options] [ft] 

An & at the end of the command line causes the client to start as a background 
process. 
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Command-Line Options 

Each client has its own set of options; certain options are available for many 
clients. For example, most viewable clients have a geometry option for 
specifying the size and position of the client window. Command-line options 
override all default files. If no options are specified, the client is started using 
resource values from the resource database, the client's app-defaults, or from 
defaults built into the client. 

Options have the syntax: 

-option argument 

For example, the following command line starts an xterm window with a black 
background and white foreground: 

xterm -bg Black -fg White & 

The next command line starts an xterm window in the workspaces named 
project 1 and project2. 

xterm -xrm '*workspaceList: project 1 project2' ft 



Specifying the Display and Screen 

The default display on which a client is displayed is obtained from the DISPLAY 
environment variable of the system on which the client starts. It sets the host, 
display number, and screen number to which the server sends output. This is 
typically display 0, screen 0. 
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Most clients have a —display option that lets you set the host, display 
number, and screen on which the client will display its output. The -display 
option has the syntax: 

—display [ host: display. screen^ 



host The hostname of a valid system on the network. 

display The number of the display on the system on which you want 

the output to appear. A display can include more than one 
screen. 

screen The number of the screen where the output is to appear. The 

default is 0. 

For example, executing the command: 

xterm —display hpthere:0.1 & 

starts an xterm process on the local system and displays the window on display 
0, screen 1 of the hpthere system (assuming the local system has permission to 
display on hpthere). The window has the default size, location, and color. 



Specifying the Workspace 

By default, clients are started in the current workspace. Some clients have a 
command-line option to start the client elsewhere. 

■ If the client has the — workspaceList option, use it to specify the workspaces 
in which the client is displayed. 

■ If the client does not have the —workspaceList option, but it does have the 
— xrm option, you can use it. The syntax for using the — xrm option is: 

{workspace-name [ workspace name ... 11 

The character string following -xrm must be quoted with right-handed single 
quotes. 
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For example, the following command line starts an xterm window that will be 
displayed in two workspaces — ^projectl and extra space. 

xterm — xxm ' *0orkspaceList : projectl "extra space'" ft 

The command: 

xterm —display lipthere:0.1 — xrm ' *vorkspaceList : project2' ft 

starts an xterm window in workspace project2 on display 0, screen 1 of 
system hpthere. 



Stopping Clients 

If a client has data yon want to save, you must save the data before you stop 
the client. For example, to save bitmap data, use the "Write Output" selection 
on the sidebar menu to save the bitmap before you stop bitmap. 

If a terminal window is running a non-client containing data, you must stop the 
non-client in the approved manner before you stop the window. 

After you have saved any data and exited any non-clients (in the case of 
terminal windows), stop the client by choosing the "Close" selection from the 
client's window menu. 

Note that if you started a non- client as an option of creating a window, when 
you stop the non- client, the window will stop. 



Running and Stopping Non-Client Programs 

A non-client normally relies on a terminal instead of a window for displaying 
its output. To start a non-client program in a window environment, create a 
terminal emulation window, and then run the non-client from the command 
prompt in that window. 

Non- clients are placed in the current workspace. 
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stopping Non-Clients 

Stop all non-clients in the manner approved in the instructions for that 
non-client. Generally, a non-client program stops automatically when it finishes 
executing or has a "stop" provision. 



Killing Programs That Won't Stop 

If you are unable to stop a program in the normal manner, you should "kill" 
the program before you log out. To kill a program, first try these keystrokes: 

■ Press (CTRL) Q- 

■ Press [CTRL] (d). 

■ Press Q. 

■ Press ( ESC ) , then Q, then Q- 

If these don't work, use the operating system "kill" command to stop the 
program's process: 

1. Save any data that needs saving. 

2. Find the PID (process ID) by executing the appropriate command for your 
operating system. (For example, in HP-UX execute ps -fu login-name.) 

3. To kill the program, execute the kill command using the PID for the 
process. (For example, in HP-UX execute kill -n pid. Use n values of 2, 
then 3 if necesary, then 9 until the process is killed.) 
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Killing Cached Clients 

Ceitain HP VUE clients are cached during a session; that is, once they are 
started, closing them unmaps the window but does not stop the process. If you 
need to halt one of these processes during a session, use the kill command. 

For example, once the file manager is running during a session, it remains 
running during the current session, even if you exit all the file manager 
windows. If you need to halt the process, you must use the appropriate kill 
command for your operating system. 
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Application Resources 



Resources are data used by applications to set their appearance and behavior. 
This chapter covers: 

■ The files used by HP VUE to create the resource database. 

■ The various ways to change resource settings. 

■ The scope of resources — how specifically or generally a resource is applied. 

■ The syntax for specifying color and geonaetry resources. 



How Applications Obtain Attributes 

The resources for an application are obtained and managed by the resource 
manager. An application can get attributes from several different places: 

■ Resources directly loaded into an application's resource database: 
n Command-line options. 

n Resources loaded into the RESOURCE_MANAGER property, 
n Certain standard resource files (for example, app- defaults files). 

■ Other sources: 

D Defaults built into the client. 

D Environment variables. 

n Inter- client communications. 
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The following list and illustration show how applications obtain resources by 
means of the resource manager: 

■ Command-line options. These options are good for only that one instance of 
the application. A command-line option is the equivalent of a client. resource 
statement in a resource file. 

■ A host environment: 

n If an XENVIRONMENT variable exists, it may contain the name of a file that 
specifies application attributes. 

D A $H0ME/.Xdefaults-/io5i file may contain resources to be used for a 
specific remote host. It is read only if no XENVIRONMENT variable exists. 

■ General user resources loaded into the RESOURCE-MANAGER property. 
See "The RESOURCE_MANAGER Property" in the next section for more 
information. 

■ User-specific files for particular classes of applications: 

D If an XUSERFILESEARCHPATH variable exists, it may specify a directory of 
files containing application class defaults for the specific user. 

D If XUSERFILESEARCHPATH variable does not exist, and if an XAPPLRESDIR 
variable exists, it may specify a directory of files containing user-specific 
application class defaults. 

n %Wi\KE./ app- class files may contain application resources. These files are 
read only if XUSERFILESEARCHPATH and XAPPLRESDIR do not exist. 

For information about these variables, refer to Programming with the Xt 
Intrinsics. 

■ Application-specific configuration files in the /usr/lib/Xll/app-def aults 
directory. Each file specifies attributes for a particular class of application. 
An app-def aults file is the equivalent of a Class* resource statement in a 
resource file. (The environment variable XFILESEARCHPATH may define a 
language-dependent location of app-def aults.) 

■ Internal defaults built into the application. 
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Command- 1 ine options 



I 



5XENVIRONMENT or 
?HOME/.Xdefaults-<host> 



RESOURCE_MaNAGER 
property string 



$XUSERFILESEARCHPATH or 
$XAPPLRESDIR or 
$HOME/<class> 



General app-defaults 



Built-in defaults 



Resources loaded by the session manager: 

$HOME/. vue/<host> : <display>/current/vue . resources 
(if it exists) 



$HOME/ . vue/<host> : <display>/home/vue . resources 
(if it exists) 



/usr/ 1 ib/Xl 1 /vue/Vuesess ion/sys . resources 
Resources loaded manually with xrdb. 
Resources changed in the style manager. 



Figure 8-1. How Applications Obtain Their Resources. 

A resource specified towards the top of the illustration overrides the 
same resource in a lower source. For instance, a resource specified in 
$1{0}{E/ .vue/ host '.display /cuTTQiit/vMe. resources overrides a resource in the 
app-defaults file; but a resource specified in the command line overrides the 
vue. resources specification. 



Note 



HP VUE does not automatically load .Xdef aults or some 
other personal resource file. Instead, resources are loaded by 
the session manager from its own database. 



For additional information about how applications obtain resources, refer to the 
discussions of the resource database in the Xt Intrinsics documentation. 
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The RESOURCE-MANAGER Property 

The RESOURCE_MANAGER property is a property on the root window that 
is treated the same way as a resource file by the resource manager. 

There are several ways that attributes are loaded into the 
RESOURCE-MANAGER property: 

■ The session manager loads resources from one of these resource files. A file is 
loaded if the file above it in the list doesn't exist. 

n $HOME/ . vuG//i05i : c/z-sp/ay/current/vue .resources. 

D $liOKE/ .vue/ host : disp/ay/home/vue .resources. 

D /usr/lib/Xll/vue/vuesession/sys.resoTirces. 

The existence of the vue. resources files depends on whether the user has 
chosen to restore the current session, and whether the user has saved a home 
session. (See "Session Startup" in chapter 6 for additional information.) 

■ During a session, the RESOURCE_MANAGER property may be modified by 
the the style manager and the xrdb client. 

■ Certain style manager customizations write to the RESOURCE_MANAGER 
property. 



Ways to Change Resources 

There are several ways to change a resource. The way you choose depends on: 

■ The nature of the resource. 

■ When you want the change to take effect — immediately, at the beginning of 
the next session, or when you choose to return to a home session. 
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Resources can be changed by: 

■ Using the style manager to change the resource interactively. 

■ By loading the new resources into the server's RESOURCE-MANAGER 
property using the X client xrdb. 

■ By hand editing a resource file. 

■ Using command-line options. 

Changing Resources Using the Style Manager 

When the system is customized using the style manager, a new resource may 
be written to the RESOURCE_MANAGER property. This depends on: 

■ The nature of the customization. Certain customizations involve resources 
(for example, changing workspace backdrops) and others do not (for example, 
adding or deleting hosts). 

■ The value of the resource Vuestyle+writeXrdblmmediate. When this 
resource is "False" (the default), the session manager is notified of font and 
mouse double-click changes, but the new resources are not written to the 
RESOURCE_MANAGER property until the user logs out. 

Normally, changes to the RESOURCE-MANAGER property are not processed 
by an application until the application is restarted. However, the style manager 
provides the ability to communicate certain resource changes immediately to 
cooperating clients. For example, the workspace backdrops can be changed 
dynamically without restarting vuewm. 
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The session manager maintains two files for storing the 
RESOURCE-MANAGER property at the end of a session: 

■ If the user has chosen to restore the current session 
at next login, the resource data is written to 

$H0ME/.vue//iO5<:df5p/ay/currGnt/vue. resources when the user 
logs out. 

■ Any time during a session, the user can choose to store 
away the current state of the resources into the file 
$HOME/ . vue/host : display /home /vue . resources. 

Refer to chapter 6 for additional information about the resource files used by 
the session manager. 

Adding and Changing Resources With 'xrdb' 

The xrdb client allows you to manipulate the resources in the server's 
RESOURCE-MANAGER property. This allows you to alter the resource 
database during a session. The changes take effect the next time the 
application is run. 

For information about the syntax of xrdb, refer to the Using the X Window 
System manual. 

Adding Resources with 'xrdb' 

To add resources, you can: 

■ Use xrdb interactively. This is useful for adding one or two resources. 

■ Create a file and merge it into the resource database. This technique is 
preferable when you want to add a number of resources. 
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Using 'xrdb' Interactively to Add Resources. To add resources interactively: 

1. Execute: 

xrdb -merge -nocpp 
in a local terminal emulation window. 

2. Type in the resource specifications. Eacli resource must be on a separate 
line. 

3. When you've typed all the resources, press [CTRL] Q to merge the resources 
and restore the shell prompt. 

Adding Resources by Merging a File. This technique allows you to type the 
resources into a file that is then merged into the database: 

1. Create a file containing the resources you want to add. 

2. Execute: 

xrdb -merge -nocpp filename 

Editing Resources Using tiie Resource Editor Action (RES.EDIT) 

The resource editor action RES -EDIT lets you edit the 
RESOURCE-MANAGER property without manually executing the 
xrdb client. 

The default RES -EDIT action uses the editor specified by the EDITOR 
environment variable. The action is written for an editor that runs in a 
terminal window (for example, vi). If the editor you want to use has its own 
windowing support, you will have to modify the action. 
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To use the default RES_EDIT action: 

1. Double-click the RES -EDIT action icon in 
$HOME/.vuG/apps/system_apps/Xll_apps. 

The action opens a terminal window, executes xrdb -query, and directs the 
output to a temporary file. It then runs the editor defined by the EDITOR 
environment variable using the temporary file as an argument. 

2. Edit the file. You can add, edit, and remove resources from the file. 

3. Store the edited file using the editor's save command. 

4. Close the terminal window. 

The action loads the temporary file into the RESOURCE_MANAGER 
properly using the xrdb -nocpp command. The temporary file is then 
removed. 

There are two ways to modify the editor used by RES.EDIT: 

■ Set the EDITOR environment variable to the editor you want to use. 

■ Modify the action itself. You may have to do this if: 

D You want to use an editor other than the one specified by the EDITOR 
environment variable. 

D The editor you want to use has its own windowing support. 
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To modify the RES_EDIT action: 

1. Copy the action, located in /usr/lib/Xll/vue/types/vue.ad, to your 
personal action definition database ($HOME/.vue/types/*.ad). 

2. Edit the copy of RES-EDIT: 

■ To specify an editor other than SEDITOR, edit the line that invokes the 
editor. For example, if SEDITOR is some editor other than vi, but you 
want to use vi to edit your resources, change: 

\$EDITOR /tmp/\$\$.xrdb ; \ 

to 

/ path/ vi/tmp/\$\$.xTdh ; \ 

■ If your editor provides its own windowing support, change the line 
TERMINAL to NO-STDIO. Also change the exec-string field of the action 
definition to remove commands for the terminal window. For example, 
the following exec-string invokes an SEDITOR editor that has its own 
windowing support: 

/bin/ksh -c '/path/xTdh -q > /tmp/\$\$.xrdb; \ 

\$EDITOR /tmp/\$\$.xrdb ; \ 

/path/xTdh -nocpp /tmp/\$\$.xrdb ; \ 
rm -rf /tmp/\$\$.xrdb' 

3. To activate the new action definition, reread the action definition 
database by double-clicking the REREAD_DB action icon in the 
$HOME/ . vue/apps/system_apps/sys_admin directory. 
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Changing and Deleting Resources Using a Resource File 

If you are familiar with using a resource file such ais .Xdef aults to manage 
resources, you may prefer to have a single resource file that you can view 
and edit. If you choose to manage resources this way, you must adapt the 
procedure for maintaining this file, keeping in mind that: 

■ The session manager automatically saves and restores resources. 

■ The style manager writes out resources. 

Use the following procedure to edit and remove resources using a defaults file: 

1. Create the file by downloading the RESOURCE_MANAGER property 
string into a file during an active session. To do this, execute: 

xrdb -edit filename 

where filename is the name of your personal defaults file. 

2. Edit the file to contain the resources you want. 

3. Load the edited file into the resource database by executing: 

xrdb -nocpp filename 

Editing Session Manager Resource Files Directly 

The session manager resource files can be edited directly. However, this should 
not be done within an active session, since the session manager may overwrite 
these files during the session or at logout. 

Table 8-1. 
Files to Edit For Changing Resources Between Sessions. 



File 
$HOME/.vue/host:display/ . . . 


When the Change 
Takes Effect 


current/vue . resources 


At the beginning of the next session if the 
user chose to restore the current session. 


home/vue . resources 


At the beginning of the next session if the 
user chose not to restore the current 
session. 
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Changing Resources for Cached Clients 

Resource changes made to clients do not take effect until the client is restarted. 

Certain HP VUE clients started from the workspace manager are cached — that 
is, they may be running but unmapped to the display. For example, when the 
file manager or help manager is closed (either from the File menu or window 
menu), the process is not halted. Closing these clients simply unmaps them 
from the display. Once these clients are started during a session, they are not 
killed until the user logs out, or until the client is closed manually using the 
operating system '"kill" command. 

HP-UX systems only: hpterm windows started from the workspace manager 
(front panel) oii HP-UX systems are also cached. At login, several unmapped 
terminal clients are started. Therefore, changes made to terminal resources 
may not take effect during the current session for new terminal windows 
mapped from the workspace manager. 
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Syntax of Resource Specifications 

Resource files are text files. They must obey the following syntax rules: 

■ Each resource specification must be on a separate line. If the last character 
on a line is a backslash (\), the new-line following the backslash is ignored 
and the resource specification is assumed to continue on the next line. 

■ To add comments to resource files: 

D Use the exclamation ( ! ) character. Anything to the right of the ! is 
interpreted as a comment. This is the preferred way of commenting all or 
portions of lines. 

D You can place a pound (#) character in column 1. This makes the entire 
line a comment. Keep in mind that you must use the xrdb option -nocpp 
when loading a commented resource to avoid it being interpreted as a 
preprocessor directive. 

■ The resource name is separated from the value by a colon ( : ) and optional 
spaces or tabs. 

The general syntax for specifying a resource for a client is: 



Kclient^name 1 
client^class J 



* resource: value 



For example: 

xtenn*cursorColor: skyblue 

sets the color of the xterm cursor to skyblue. 

Certain clients allow you to set resources for particular parts of the client. For 
example, 

xterm*scrollBar*background : mediumblue 

sets the scrollbar on xterm windows to mediumblue. 
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Color Resources 

Colors can be specified several ways: 

■ By the color set Id resources. The color set Id is a number representing the 
color set in the current palette that will be used to color display elements. 
There are four color set Id resources: 

n primaryColorSetId 

D secondaryColorSetId 

n activeColorSetId 

n inactiveColorSetId 

For example, the following line specifies that the background of the client 
xclock will be colored based on color set 3. 

xclock*priinaryColorSetId: 3 

Color sets are covered in more detail in chapter 9. 

■ Using resources that take coloi names or rgb numbers as their values. 
n The file /usr/lib/Xll/rgb.txt lists all the named colors. 

D The rgb numbers have the syntax: 

f^RedGreenBlue 

where Red, Green, and Blue are hexadecimal numbers containing 1, 
2, 3, or 4 digits that indicate the amount of that primary color used. 
There must be the same number of digits for each of the primary colors. 
Thus, valid color values consist of 3, 6, 9, or 12 hexadecimal digits. For 
example, black can be specified by any of these rgb values: #f f f , #f f f f f f , 
#ffff ff fff , or #ffffffff ff ff . The style manager uses rgb values when 
writing out color information to its palette files. 

For example, the following line specifies the background color of xterm icons: 

Vuewm*xterm*iconImageBackgroimd : DarkSlateGrey 
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Use these guidelines when deciding how to color a display component: 

■ Use a color set Id when yon want the color to reflect the current palette 
scheme. For example, specifying: 

xterm*primaryColorSetId: 6 

causes the background of xterm windows to be based on color set 6. The 
color of the xterm windows will change when the user switches to a different 
palette. 

■ Use actual color resources when you want the component to be a particular 
color, regardless of the current palette. For example, 

Vu6wm*menu*backgroimd: wheat 

specifies the color for window manager menus. You should be aware that the 
style manager will not automatically create a pleasing 3-D effect for colors 
specified explicitly. 

The style manager's Modify Color dialog box provides controls for adjusting 
and viewing colors. The R, G, and B sliders are labeled with decimal values 
through 255. To create an rgb value, convert each slider value to a two-digit 
hexadecimal equivalent and then combine them. 
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Geometry Resources 

The geometry of a window is its size and location. The syntax for geometry 
resources is: 

' Widthx Height 
[-]{ :Lcolumn±row 

Widthx H€ight±column±row 

Use a lower-case x for the times sign. 

Width The width in characters (for terminal windows) or pixels 

(for other clients). For widths in characters, the window size 
depends on the font size. 

The height of the window in lines (for terminal windows) or 
pixels (for other clients). The height of a terminal window 
depends on the font. 



Height 



column 



row 



The column location of the window in pixels. 

The location of the left side of the window 
relative to the left side of the workspace. 

The location of the right side of the window 
relative to the right side of the workspace. 

The row location of the window given in pixels: 



Plus (+) 
values 

Minus (-) 
values 



Plus (+ ) The location of the top of the window relative 

values to the top of the workspace. 

Minus (— ) The location of the bottom of the window 

values relative to the bottom of the workspace. 
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Table 8-2. Example Locations for an 80x24 Terminal Window. 



To position a window here . . . 


Use this location . . . 


The upper left corner of the workspace. 


+0+0 


The lower left corner of the workspace. 


+0-0 


The upper right corner of the workspace. 


-0+0 


The lower right corner of the workspace. 


-0-0 



For example, the following line specifies that all xterm windows be created 80 
characters wide and 24 characters high, and that they are initially placed in the 
upper right corner of the display. 

xterm*geometry: 80x24-1+1 



Scope of Customization 

Scope of customization determines how generally or specifically a resource is 
applied. For example, you can specify that all clients have a background color 
of black (very general). At the other extreme, you can say that you want the 
softkeys of one particular xterm window to be red. 

Scope of customization is determined by: 

■ Using names or classes of clients. 

■ Using names or classes of resources. 

■ Specifying particular areas of clients (for example, softkeys and scrollbars). 

■ Using wildcards in the resource string. 
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Names and Classes of Clients 

Every client has both a name and a class. The name defines the specific client, 
while the class categorizes the client. Thus, the class is more general than the 
name. 

Frequently, the two identifiers are very similar, and often differ only in 
capitalization. For example, the client named vuestyle belongs to class 
Vuestyle. 

Resources specified by client name take precedence over resources specified by 
client class. 

Naming a Client 

You can assign a nam.e to a particular instance of a client. This allows you to 
allocate resources to that client by class, by client, and by name. 

For example, the following command line starts an instance of xterm named 
localTerminal. 

xterm -name localTerminal 

If the following resource exists in the resource database: 

localTerminal*scrollBar: True 
localTerminal*background: white 

then the localTerminal window will have a scroll bar and be white, overriding 
the colors used by the current palette. 

Names and Classes of Resources 

Like clients, resources have both a name and a class. 

An individual resource begins with a lowercase letter. For example, 
foreground refers to the foreground resource. A class resource, however, 
begins with an upper-case letter. For example. Foreground refers to the the 
entire class of foreground resources. 

Thus, if no other specifications overruled, the line *foreground: blue 
in your resource file would make all foregrounds blue. However, the line 
♦Foreground: blue would make all resources that belonged to the Foreground 
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class blue. This would include such resources as foreground, cursorColor, 
pointerColor, bottomShadowColor for softkeys, frames, icons, and mattes. 

Name/Class Precedence 

Specific resource specifications always have precedence over general 
specifications. For example, suppose a resource file contains: 

♦Foreground: red 

Xterm*Foreground : DarkSlateGray 

Xterm*foreground: coral 

Xterm*cursorColor: green 

The first line makes all resources of the class Foreground red. The second 
line overrules the first line, but only in the case of clients of class Xterm 
(of which there is only one— the xterm client itself). Line two makes the 
Foreground class resources of all xterm clients DarkSlateGray. Lines three and 
four give xterm clients coral foregrounds and green cursors, while the other 
resources of class Foreground (pointerColor, cursorColor, softkey foreground 
and bottomShadowColor, and scrollbar foreground and bottomShadowColor) 
remain DarkSlateGray for xterm clients. 

Similarly, if a resource file contains: 

xterm. name: local 

Xterm*softkey*background: wheat 

Xt erm*b ackgr o\md : p ink 
local*background: white 

then all softkey backgrounds will be wheat. For the rest of the xterm window, 
the backgrounds will vary. Windows named local will be white, other windows 
will be pink. 
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Wildcards and Exact Paths 

The * character in a resource string is a wildcard that provides resource 
generality. For example, the following list of resources shows increasing 
specificity. 

♦foreground: white 

xterm*foreground: yellow 

xt erm* s of tkey *f oreground : red 

The resource *f oreground refers to all foregrounds. The more specific 
resources override it. All the xterm foregrounds will be yellow except for the 
foreground of the soft keys. 
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9 



The Viewable HP VUE Clients 



This chapter covers customizing the viewable HP VUE clients — that is, the 
clients that display windows. It covers these topics: 

■ How to change resources for the HP VUE clients. 

■ Using the xterm or hpterm terminal emulator. 

■ How the style manager manages colors and various system settings. 

■ How the style manager changes other settings. 

■ Client caching. 

■ Customizing the help manager, file manager, and xload. 
Aspects of several HP VUE clients are covered in other chapters: 

■ Setting resources using the xrdb client is covered in chapter 8. 

■ The window manager (vuewm) is covered in chapter 11. 

■ The databases used by the file manager are covered in chapter 12. 

■ The workspace manager (front panel) is covered in chapter 13. 
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Setting Resources for the HP VUE Clients 

The app-defaults (system-wide application defaults) files for the various clients 
contain a number of resources for customizing the appearance of the clients. 
The files are located in directory /usr/lib/Xll/app- defaults, and are named 
according to the class name of the client. For example, app-defaults for the 
vuestyle client are located in /usr/lib/Xll/app-def aults/Vuestyle. 

Resources for a client can be modified on a system- wide or per-user basis. 

■ To modify system-wide resources, edit the app-defaults file for the client. 

■ To modify resources on a per-user basis: 

1. Copy the app-defaults file to another file. Give that file write permission. 

2. In the new copy, remove lines for resources you will not be changing. 

3. Edit the resources you want to change. Add the client class name to the 
beginning of the resources, so that they have the syntax: 

Classname* resource : value 

For example, to set the maximum value for the tone duration scale to 30, 
use the resource: 

Vuestyle*durationScale .maximum: 30 

4. Merge the file into the resource database by executing: 

xrdb -merge -nocpp file^name 
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Terminal Emulation 



Terminal Characteristics 

The login manager does not perform the normal console login. Consequently, 
your terminal characteristics may not be what you expected; you may need to 
set the special control characters and process group control characters with a 
resource. 

By default, the session manager sets the following special control characters 
and process control characters: 

Table 9-1. Control Characters for Terminals. 



Control Name 


Control 
Character 


erase 


^H 


intr 


X 


kill 


^U 


start 


^Q 


stop 


^S 



You can set any of the following: quit, eof, elo, swtch, brk, susp, dsusp, rprnt, 
flush, weras and Inext. 

To set the resource for your control characters, add the following resource to 
your resources file. 

♦ttyModes: name ^C 

where name is the name of a control character and C is the character. 

You can configure a single terminal window by sourcing in the appropriate files. 
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Process Caching for the 'hpterm' Terminal Emulator 



Note 

4 



This section applies only to systems that support the hpterm 
terminal emulator. HP VUE does not use process caching for 
xterm. 



Each time a session is started, several cached terminal processes are started — 
that is, their processes are running but their windows are not displayed. 
Clicking the terminal emulator button on the workspace manager accesses one 
of these processes and displays the window. The terminal processes started 
from command lines do not use these cached processes. 

The system maintains two cached terminal processes; as their windows are 
mapped, additional unmapped processes are started to replenish the cache. 
When a window is closed, a process is returned to the cache. 

The following table lists some of the vuecoiranand resources for customizing 
caching behavior and the appearance of cached windows. 

Table 9-2. Terminal Caching Resources. 



Resource 


Description 


Default 


minCache 


The minimum number of terminal 
windows to pre-start at the beginning of a 
session 


2 


maxCache 


The maximum number of terminal 
windows to keep in the cache. 


4 


terminalName 


The window name for the terminal 
window 


Terminal Window 


terminal I con 


The icon label 


Terminal 



For example, the following line specifies that the terminal name for terminal 
windows displayed from the workspace manager is Local: 

Vuecommand+terminalName : Local 



9-4 The Viewable HP VUE Clients 



The Style Manager 

This section covers: 

■ Opening and closing the style manager. 

■ Resources controlling the appearance of the style manager. 

■ Customizations by the Style Manager. 

■ How the style manager sets colors and manages the color map. 

Opening and Closing the Style Manager 

The style manager is started by clicking the style manager control in the 
workspace manager. The executable file is /usr/bin/Xll/vuestyle. 

There can be only one style manager running. Attempting to start another 
vuestyle process from a command line (for example, from a menu or a 
terminal emulator) will fail. 

Style Manager Resources 

The app-defaults file (/usr/lib/Xll/app-defaults/Vuestyle) contains a 
number of resources for changing the appearance of the style manager. 
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style Manager Customizations 

The following table lists the major categories of customizations done by the 
style manager. 

Table 9-3. Style Manager Customizations. 



Customization 


Description 


Covered 
in chapter . . . 


Color 


Client, window manager, and workspace colors. 


9 


Fonts 


Fonts used for system and user areas in 
applications. 


8 


Backdrop 


Bitmaps used as workspace backdrops. 


11 


Keyboard 


Click volume and autorepeat. 


9 


Mouse 


Double-click time, acceleration, and threshold. 


9 


Audio 


Beeper volume, tone, and duration. 


9 


Screen 


Screen saver behavior. 


9 


Hosts 


Specifies which remote hosts can access the local 
server. 


4 


Startup 


Session startup behavior. 


6 



Using the 'xset' Client 

The xset client allows you to change certain user preference options of the 
display. All of these setting are saved by the session manager when the 
session manager queryserverSettings resource is True. Note that hardware 
limitations and implementation differences may affect the results of the xset 
client. 
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The following functionality provided by the style manager is also provided 
by the xset client. These settings are always saved by the session manager, 
regardless of the value of queryServerSettings: 

■ Bell volume, pitch, and duration. 

■ Keyboard click volume and autorepeat. 

■ Mouse acceleration and threshold. 

■ Screen saver time. 

Using the 'xhost' Client 

The xhost client provides an alternative to the style manager Hosts dialog box 
for dynamically controlling access to your local system. Using xhost, you can 
add or delete a remote host's permission to access the local display server. 

For example, the following command allows the remote host hpcvf gg to access 
your local display. 

xhost +hpcvfgg 

The change is saved by the session manager when you log out. 

How the Style Manager Sets Colors 

The style manager provides the ability to select a color scheme for display 
com.ponents from a variety of built-in and user-created palettes. 

This section covers: 

■ How the style manager interacts with HP VUE and X clients. 

■ The files used to store palette information. 

■ Setting the palette configuration, which determines how many color sets each 
palette has. 

■ The color sets contained within color palettes, and how those colors relate to 
display components. 

■ How to minimize color usage. 
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Changing Colors Dynamically 

The style manager provides the ability to change the client colors. 

In order for a client to respond to the style manager palettes, the following 
must be true: 

■ The client must be an HP VUE client or another client written using the 
OSF/Motif 1.1 or later toolkit. X clients written with other toolkits do not 
have the ability to adopt new color resources dynamically. For those clients, 
a change made in the style manager does not take effect until the client is 
restarted. 

■ There must be no other specific color resources specified for the client. (This 
includes user-specified resources, app-defaults, and resources built into the 
client.) 

Color Palette Files and Their Locations 

The style manager provides a set of color palettes for selecting color schemes 
for window frames and HP VUE applications. 



Palettes 



Color sets and 
their numbers 



»| Color 






CoralReef 
Dakota 
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Equinox 
Esquire 


1 1 ftdd... 1 
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^.____j 








I ok' 1 ! Cat^i 


"1 r-ij^i--"! 







Figure 9-1. The Color Palette Dialog Box. 
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A file exists for each color palette. The resource paletteDirectories specifies 
the directories containing palette files. Its default value specifies these 
directories: 

■ The usr/lib/Xll/vue/palettes directory, which contains files for the 
palettes shipped with HP VUE. 

■ The $HOME/.vue/palettGs directory, which contains new palettes and 
palettes that were created by modifying built-in palettes. 

When the user selects a palette, it is stored into the file 

$iiOKE,/ .vue/ host : display /jtailette ,vue. This allows the session 

manager to restore the current palette at the beginning of the next session. 

Specifying Palette Configuration 

A palette consists of a group of color sets. Each set is represented by a color 
palette button in the Color Palette dialog box. 

The number of color sets in a palette is determined by the display type and the 
colorUse resource, which has the syntax: 



♦colorUse: < 



LOW.COLOR 
MEDIUM.COLOR 
[ HIGH.COLOR 
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The default value is set according to the number of color planes being used. 

Table 9-4. Palette Configuration. 



Configuration 


Number of 
Color Sets 


Maximum 

Number of 

Colors 


Default 
Number of 
Colors Used 


ConJfiguration is 
Default for this 
many planes . . . 


B_W 


2 


2 


2 


1-3 


LOW-COLOR 


2 


12 


8 


4-5 


MEDIUM_COLOR 


4 


22 


22 


6 


HIGH_COLOR 


8 


42 


42 


7 or more 



There are four palettes for B_W. 

Color Sets 

Each color palette button in the Color dialog box represents one color set. 

There are up to five colors in a color set. The colors affect these display 
components: 

■ f orGgroxmd. This is the foreground of the application window or window 
frame, and is always black or white. 

■ backgro\md. This is the background of the application window or window 
frame. 

■ topShadowColor. This is the color of the top and left bevels of application 
controls (push buttons, text boxes etc) and window frames. 

■ bottomShadowColor. This is the color of the bottom and right bevels of 
application controls and window frames. 

■ selectColor. This is the color of certain controls — for example, depressed 
buttons, editable areas, and slider bars. 

The number of colors in a color set depends on two resources — shadowPixmaps 
and f oregroundColor. 
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How Top and Bottom Shadows are Colored. The resource shadow? ixmaps 
determines how the 3- dimensional effects are created on the display. 

■ When "True," the system creates a topShadowPixmap and 
bottomShadowPixmap for the bevels instead of a topShadowColor and 
bottomShadowColor. This reduces the number of colors in a color set by 2. 

■ When False, the system uses solid colors for the bevels. 

Table 9-5. Default Values for the shadowPixmaps Resource. 



Display 


Value 


B_W 


ignored 


LOW-COLOR 


True 


MEDIUM-COLOR 


False 


HIGH-COLOR 


False 
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Setting the Foreground Color. The syntax for specifying the foreground color is: 



*f orGgroundColor : < 



( White 
Black 
^ Dynami 



J 



If the value is set to White or Black, all foregrounds are set to that color, and 
the number of colors in a color set is reduced by 1. The foreground will not 
change in response to the background color. 

If the value is set to Dynamic, the foreground changes in response to the 
background color. 

Table 9-6. Default Values for foregroundColor Resource. 



Display 


Value 


B_W 


ignored 


LOW-COLOR 


Dynamic 


MEDIUM_COLOR 


Dynamic 


HIGH_COLOR 


Dynamic 



Computing How Many Colors a Palette Uses 

The minimum number of colors used by the style manager is the number of 
colors used by a palette. This number depends on the values for these style 
manager resources: 

■ colorUse. 

■ shadow? ixmaps. 

■ foregroundColor. 

The number of colors in a palette is calculated by multiplying the number of 
color sets in the palette by the number of colors in each color set, then adding 
black and white (these are always allocated by the server). 
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For example, consider a configuration with these settings: 

*colorUse: MEDIUM.COLOR 

* shadow? ixmap s : True 

*f oregroundColor : White 

MEDIUM-COLOR configurations have 4 color sets. Each color set includes 
a background color and selectColor. (There is no topShadowColor, 
bottomShadowColor, or f oregroiind. The bevels are colored using pixmaps 
and the foreground is always white.) Therefore, the number of colors used by a 
palette is 4 X 2 + black + white = 10. 

Here is another example: 

♦colorUse: HIGH.COLOR 

* shadowP ixmap s: True 

*f oregroundColor : Dynamic 

In this configuration, there are 8 color sets. Each color set includes a 
backgroimd, foreground (since f oregroimdColor is set to Dynamic), and 
select color. Therefore, the number of colors used by a palette is 8 X 3 + black 
+ white = 26. 
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Mapping Display Components to Color Sets 

Color sets in a palette are mapped to display elements by the following 
resources. The value of each resource is an integer representing a color set. 

Table 9-7. 
Resources for Assigning Color Sets to Display Elements. 



Resource 


Display Element 


Default 
Colorset 


activeColorSetId 


Active frame color. 


1 


inactiveColorSetld 


Inactive frame color. 


2 


primacryColorSetId 


Application's primary colors (main background 
area). 


3 


secondsoryColorSetld 


Application's secondary colors (menubar, 
menus, dialog boxes). 


4 



By default, all HP VUE clients use the same primaryColorSetId to 
group them visually. However, the app-defaults include client-specific 
secondaryColorSetId resources: 

Table 9-8. Default Secondary Color Sets. 



Client 


Client-specific 
secondaryColorsetId 


Style manager 


7 


Help manager 


6 


File manager 


5 



This provides a degree of color coding — for example, the user can visually 
associate dialog boxes with their parent application windows by matching 
the colors of the menubars and dialog box backgrounds. Note that this 
color differentiation is only visible on HIGH_COLOR displays. For 
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MEDIUM-COLOR and LOW-COLOR displays, color set Id's of 7, 6, and 5 
are mapped to available color sets. 

The following example shows how yon would group all xterm windows by 
specifying that they use color set 8 for their primary color. 

xterm+primairyColorSetld: 8 

Color Resources Affected by the Style Manager 

When the user changes palettes, color values in the newly chosen palette are 
written to the following resources in the server's RESOURCE-MANAGER 
property string: 

■ *background. 

■ *f oreground. 

These resources will determine the background and foreground colors of clients 
other than those created using the OSF/Motif 1.1 toolkit or toolkits following 
OFS/Motif 1.1. The resources take effect the next time the clients are started. 

If the user has a more specific color specification in the resource database, that 
resource overrides the style manager. For example, if the resource database 
contains: 

xtena*backgroimd: green 
vuewm*topShadowColor : pink 

then those colors will persist regardless of changes made using the style 
manager. 

Note Specific color resources affect only the display element 

I controlled by the resource. Thus, it may require multiple 

^Kl resources to create a pleasant 3-D effect. For example, 

specifying topShadowColor for window frames does not provide 

appropriate colors for other frame elements. 
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Turning Off Dynamic Colors 

The dynamicColor resource provides a way to reduce color usage. It controls 
whether clients change colors dynamically and has a default value of "True" — 
clients change color when the user switches palettes. When the resource is set 
to "False," clients will not respond dynamically to palette changes. 

This is how setting dynamicColor to "False" reduces color usage. When 
dynamicColor is "True," clients that cannot change colors dynamically allocate 
different cells in the color map than those used by clients that change colors 
dynamically. When dynamicColor is set to "False," all clients share the same 
color cells. 

Reducing Color Usage 

Several factors contribute to color usage by HP VUE: 

■ The style manager must use some color cells for its active color palette. 

■ HP VUE clients may require additional colors. For example, the style 
manager uses additional color cells for its red, green, and blue scales; 
vuelogin requires colors for the login screen. 

■ Applications may specify client-specific color resources (for example, 
bitmap*foreground: yellow). Colors specified this way use additional color 
cells. 

■ Client that do not change colors dynamically (clients built using OSF/Motif 
prior to version 1.1, or non-OSF/Motif clients) use different color cells than 
clients that change color dynamically. 
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If the system runs out of color cells, you may want to reduce the nunaber of 
colors in use. There are several ways to do this: 

■ Let the style manager handle color resources as much as possible. In other 
words, minimize color resource specifications in resource files. 

■ Use pixmaps instead of colors for the shadow colors. (Set the shadowPixmaps 
resource to True. 

■ Use White or Black for the foreground color, rather than letting the system 
determine the color dynamically (use the f oregroundColor resource). 

■ After the user has settled on a color scheme, set the *dynamicColor resource 
to False. 

■ Set the colorUse resource to a lower value. For example, if you have a 
MEDIUM_COLOR display, setting colorUse to LOW.COLOR will reduce the 
number of colors used by the current palette. 

Changing Mouse Double-Click Time 

Changing the mouse double- click time in the style manager changes the 
resource multiClickTime. By default, the style manager notifies the session 
manager of the change, and the new resource specification is written to 
VUG. resources when the user logs out. Therefore, the change does not take 
effect until the next session. 

When the resource Vuestyle+writeXrdblmmediate is "True," the change is 
written immediately to the RESOURCE-MANAGER property string, and 
applications use the new double-click time the next time they are started. 

Other Mouse, Keyboard, and Screen Customizations 

Changes to mouse acceleration and threshold, beeper settings, keyboard click 
and autorepeat, and screen saver parameters are implemented by changing 
preferences for display options. (These changes were previously done using 
the xset client). HP VUE does not support changes to beeper settings for 
Domain/ OS systems. 

The changes take effect immediately and are saved by the session manager in 
its vue. settings file. 
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When Customizations Take Effect 

These factors affect when customizations take effect: 

■ Changes that are implemented by changing preferences for display options 
take place immediately. 

■ Some resource changes take effect dynamically — that is, they take effect 
without having to restart the application. An example is changes to the 
Vuewm*backdrop* image resource for changing backdrop bitmaps. 

■ In general, the state of an attribute is undefined when the dialog box for that 
resource is open. Users should close all style manager dialog boxes before 
logging out in order for changes made in them to be written out by the 
session manager. 

■ Font and mouse double-click changes take effect the next time the user logs 
in (by default), or the next time the application is restarted. 



Use style manager 

to 

change resource 



Yes 




Notify session 
manager of new 
resource . ( Change 
takes effect at 
next login.) 



No 



Write new resource 
to the resource 
database. (Change 
takes effect the 
next time the 
client is started.) 



Figure 9-2. 
The writeXrdblmmediate Resource Affects Font and Mouse Double-Click 

Changes. 
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Customizing the Help l\/lanager 

This section covers: 

■ How opening and closing the help manager windows is related to the actual 
vuehelp process. 

■ Customizing the appearance of the help manager windows. 

■ Configuring systems to access the HP LaserROM/UX from the Help Viewer's 
Browse menu. 

Opening and Closing the Help Manager 

The help manager is started: 

■ By clicking its control in the workspace manager. 

■ By selecting an entry in the Help menu of an application window. 

■ When the user clicks [Help] in a dialog box. 

There can be only one vuehelp process running during a session. Its process 
has three main windows — the Help Viewer, Help Index, and Help Snapshot. All 
applications using the help manager share the Viewer and Index windows. 

You should not attempt to start a second vuehelp process. 

The help manager is a cached client — that is, once it is started during a 
session, the process remains running until the session is ended. Closing all help 
manager windows unmaps the windows from the display but keeps the vuehelp 
process running. 

Help Manager Resources 

The app-defaults file (/usr/lib/Xll/app-def aults/Vuehelp) contains a 
num.ber of resources for customizing the appearance of the help manager 
windows. 
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In addition to basic font resources, there are resource specifications for the 
three help manager windows. These have the syntax: 



Vuehelp* 



' index 
topic 
viewer 



} 



resource : value 



index The Help Index window. 

topic The Help Viewer window. 

viewer The Help Snapshot window. 

For example, to expand the width of the Help Viewer to 80 columns, use the 
resource: 

Vuehelp*topic . columns : 80 

Accessing the HP LaserROM/UX From the Help Manager 

Note This section applies only to systems that support HP 

LaserROM/UX. 



4 



The Browse menu in the Help Viewer window contains an entry for accessing 
the HP LaserROM/UX. In the default configuration, the menu item is greyed 
out. 

To activate the menu item: 

■ Copy the file /usr/lib/Xll/vue/types/laserrom.ad to $HOME/.vue/types. 

■ Uncomment the action definition in the file by removing the # at the 
beginning of the line: 

LASERROM * ${ACTIOI_L} ${ACTIOI_S} COHHAID lO-STDIO %LocalHost% laserrom 

The action assumes that the HP LASERROM/UX application and database 
are located locally. If necessary, modify the action to access the appropriate 
remote system. 
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Log out and then back in. The HP LaserROM/TJX item will be active the 
next time the Help Manager is started. 



The File Manager 

The executable file is /usr/bin/Xll/vuef ile. 

Opening and Closing the File Manager 

The file manager is started by clicking the file manager control in the 
workspace manager. 

The user can open multiple file manager windows; however, there will be 
only one vuef ile process running that supports all the opened file manager 
windows. You should not attempt to start another vuef ile process from a 
command line (for example, from a menu or terminal emulator). 

The file manager is a cached client — that is, once it is started during a session, 
the process remains running until the session is ended. Closing all file manager 
windows unmaps the windows from the display but keeps the vuef ile process 
running. 

Viewing Large Files 

By default, the VIEW action in the file manager's Action m.enu (for data files) 
returns an error for files larger than 512,000 characters. The maximum number 
of characters can be changed using the vuehelp resource f ileSize. It has the 
syntax: 

Vuehelp*f ileSize : number_of-characters 

For performance reasons, you should not specify a value larger than the default 
unless necessary. 
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The 'xload' Client 

The default workspace manager contains an xload client running in it. It is 
started with the nolabel command-line option, xload displays a histogram of 
the current system load of the local system. 

By default, xload measures the average load on the system using a scale of 
(no load) to 1 (a single division). The -scale division option specifies the 
minimum number of divisions to be used. 

If the load exceeds the number of divisions, extra divisions are drawn 
automatically. 

You can customize the workspace manager xload by: 

■ Restarting it with new command-line options. 

■ Specifying resources for it using its resource name vueload. For example, the 
following resource specifies that xload will use color set 8 for its background 
color: 

vueload*primaryColorSetId: 8 

To kill and restart xload: 

1. Determine the pid (process-ID) of the xload process by executing the 
appropriate operating system command. (For example, the HP-UX 
command ps -fu login^name I grep xload). 

2. Kill the process by executing the appropriate kill command (for example, in 
HP-UX: kill -9 pid 

3. Restart xload by executing: 

xload -name vueload I- option] ... & 

Make sure you include the -nolabel option if you do not want a label in the 
histogram. 

For example, the following command line starts xload with a scale factor of 
3. 

xload -name vueload -nolabel -scale 3 k 
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Using Fonts 



A font is a type style in which text characters are printed. HP VUE and the X 
Window System include a variety of fonts: 

Bitmapped fonts are made from a matrix of dots. The font is completely 
contained in one file. Many files are needed to have a complete range of sizes, 
slants, and weights. 

Scalable typefaces are each defined by a file containing a mathematical outline 
used by the system to create a bitmapped font for a particular size, slant, or 
weight. Scalable fonts are not available on systems running HP-UX releases 
prior to HP-UX 8.0. 

This chapter covers: 

■ Using the HP VUE Style Manager to set fonts. 

■ Setting font resources for HP VUE. 

■ Displaying samples of fonts. 

Note For additional information about fonts, refer to the manual 

Using the X Window System. 
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Specifying Fonts Using the Style Wiarxager 

This section covers: 

■ The resources used to specify the font choices displayed by the style manager 
Fonts dialog box. 

■ How the style manager writes out the user's choice to the general font 
resources that control the actual fonts used by the clients. 



Fonts 



j™„ r Font Preview 

Foot Size I Hediuw s»| 



-By Application: 

'crab flppiication | 



Application Hame 



imi appli 



Areas where you can 
type will look like 
this. Select the 
box below and type 
there if you like. 

Type here 



OK 



Cancel 



Help 






Figure 10-1. Fonts Dialog Box 
Font Choices Displayed by the Style Manager 

Selecting a font size from the Fonts dialog box option menu chooses two fonts: 

■ The system font. It will be used for system areas such as menu bars, menus, 
push buttons, toggle buttons, and labels. 

■ The user font. It will be used for text entered into windows. 

The following style manager resources specify the fonts available to the user in 
the Fonts dialog box. They use the syntax: 

Vuestyle* resource: value 
where value can be an X logical font description (xlfd) or a font alias. 
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Table 10-1. Resources for Setting Style Manager Fonts. 



Resource 


Display Resolution 


Description 


smallSysFontMR 

meditunSysFontNR 

largeSysFontMR 


Medium 


System fonts used for menu bars, 
menus, push buttons, labels, and 
other system areas. 


smallSysFontHR 

mediiinSysFontHR 

largeSysFontHR 


High 


System fonts used for menu bars, 
menus, push buttons, labels, and 
other system areas. 


smallUs erFont MR 
mediumUs erFontMR 
largeUserFontMR 


Medium 


Fonts used for text the user types. 


smallUs erFont HR 
mediumUs erFontHR 
laorgeUs erFont HR 


High 


Fonts used for text the user types. 



The default values for these resources are in 
/usr/lib/Xll/app-defaults/VuestylG. 
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General Font Resources Accessed by the Style Manager 

When the user selects a font size from the Fonts dialog box, the change affects 
the following resources: 

Table 10-2. General Font Resources. 



Resource Written 


Description 


Font Written 


Font 


General user font for non-OSF/Motif 
and OSF/Motif 1.0 clients. 


User 


FontList 


Displayed in system areas of HP VUE 
clients and other clients created using 
the OSF/Motif toolkit. 


System 


XmText*FontList 
XmTextField+FontList 


Displayed in the text entry boxes of 
HP VUE clients and other clients 
created using the OSF/Motif toolkit. 


User 


systemFont 
user Font 


Used by application developers to 
specify the current system and user 
fonts for their applications. 





For example, if the user chooses the "Large" option from the Fonts dialog box, 
the following resources will be in effect on a high resolution display either at 
the next session (the default) or when applications are started (see the next 
section for more information). 



♦Font : Value 

♦FontList : Value 

♦XmText ♦Font List: Value 

♦XmTextField^FontList : Value 

♦systemFont: Value 

♦userFont: Value 



of largeUserFontHR 
of largeSysFontHR 
of largeUserFontHR 
of leirgeUserFontHR 
of largeSysFontHR 
of leurgeyserFontHR 
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Choosing When Font Changes Take Effect 

By default, changes made in the Fonts dialog box are 
reported to the session manager, which writes them out to 
$H0ME/.vue//iO5i:c?isp/ay/current/vue. resources at the end of the 
current session. Thus, changes do not take effect until the beginning of the 
next session. 

When the resource writeXrdblnimediate is set to "True," font changes are 
written to the resource database when the user clicks [OK] in the Fonts dialog 
box. The new font will be used for clients started after the change is made. 



Use Font dialog box 

to select the 

font size. 



Yes 




Notify session 
manager of font 
change . ( Change 
takes effect at 
next login.) 



No 



Write font change 
to the resource 
database. (Change 
take effect the 
next time the 
client is started.) 



Figure 10-2. Specifying When Font Changes Talce Effect. 

Due to caching of some HP VUE clients, closing a client window (from the 
File or window menu) and starting another one from the workspace manager 
may not start a new instance of the client. Therefore, font changes written 
immediately to the resource database may not be incorporated into clients 
started from the workspace manager until the user logs out and back in. 
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Specifying Fonts For Particular Clients 

You can specify fonts for particular clients by: 

■ TJsing the [Grab Application] button in the Fonts dialog box to specify the 
client name. 

■ Manually specify font resources for a particular name or class of clients. 

Syntax for Client-Specific Fonts 

Fonts for a particular client can be specified by the syntax: 

{client^class 1 , - 

,. , >* fontresource: fontname 

chent^name J 

fontresource The name of the resource for the client. 
fontname The name, alias, or xlfd name for the font. 

Setting Client-Specific Fonts with the Style Manager 

The [Grab Application] button in the Fonts dialog box grabs the application 
name. For example, if you grab an xterm window, the following font resources 
will be written to the resource database. 

xterm*Font: fontname 

xtGrm*FontList: fontname 

xterm* XmText*FontList : fontname 

xterm* XmTextField*FontList : fontname 

xterm* systemFont : fontname 

xterm*userFont : fontname 
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If the xterm that was grabbed had been started by the command line: 

xterm -name remote.terminal 

then these resources would be written out: 

remote_terminal*Font : fontname 

rGmote_tenninal*FontList : fontname 

remotG_terminal*XmText*FontList : fontname 

remotG.terminal*XmTextField*FontList : fontname 

remote_terminal*systGmFont : fontname 

remote_terminal*userFont : fontname 



Specifying Resources Manually 

You can add client- specific font resources manually using xrdb. For example, 
the following line in your resource file changes the font of xterm windows to the 
monospace font -*-courier-bold-r-*-8-*: 

XtGrm*f ont : -*-courier-bold-r-*-8-* 



Displaying a Font (xfd) 

You can display the complete character set of any valid HP VUE font using the 
xfd client. 

The xfd client is described in the Using the X Window System manual. 
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The Window Manager 



The window manager is a client that: 

■ Provides multiple workspaces and the ability to switch from one to another. 

■ Manages the general appearance of window frames and icons. 

■ Creates the window menu and the workspace menu. 

■ Manages mouse button bindings and keyboard key bindings. 

■ Sets the focus policy. The focus policy determines how the user directs the 
system to change the input focus from one window to another. 

The window manager also creates the workspace manager (also called the front 
panel). Customizing the workspace manager is covered in chapter 13. 



Running the Window l\/lanager 

The window manager client vuewm is started automatically by the session 
manager. By default, it is started on one screen. 

For configurations not running the session manager, the window manager is 
started using the syntax: 



vuewm [-option ... ] 
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11 Window Manager Resource Files 

This section covers: 

■ How the window manager obtains client-specific resources for its appearance 
and behavior. 

■ The resource configuration files used specifically by the window manager. 

How the Window Manager Obtains Resources 

Like other clients, the window manager obtains its resources from a variety of 
sources. The primary sources are: 

■ The file /usr/lib/Xll/app-defaults/Vuewm. 

■ The resources loaded into the RESOURCE-MANAGER property at the 
beginning of an HP VUE session. 

■ Resources manually loaded into the RESOURCE-MANAGER property using 
the xrdb client. 

Changes to vuewm resources take effect when the window manager is restarted. 

How clients obtain their resources is covered in more detail in chapter 8. 
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Window Manager Configuration Files ^^ 

The window manager uses one of the following files to set up the workspace 
manager, window and workspace menus, and key and button bindings: 

■ The file specified by the resource VuGwm*conf igFile. 

■ $HOME/.vue/vuewmrc. 

■ /usr/lib/Xll/vue/Vuewm/sys.vuGwmrc. This is the default file shipped 
with HP VUE. It is used if $HOME/ . vue/vuewmrc doesn't exist. 

To create $HOME/. vue/vuewmrc, copy the default file, give it write permission, 
and then modify it. 

Caution The update process for HP VUE replaces any previous version 

• of /usr/lib/Xll/vue/Vuewm/sys.vuewmi-c. If you modify this 

file and want to preserve your changes, you should move the file 
before updating. 

If the LANG environnaent variable has been set, the system searches for 
language-dependent files: 

■ The file specified by the resource Vuewni*conf igFile. 

■ $HOME/.vue/y,L/vuGwmrc. 

■ /usr/lib/Xll/vue/Vuewm/y.L/sys.vuewmrc. 

Changes to the configuration file take effect when the window manager is 
restarted. 
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11 Syntax For Window Manager Resources 

The syntax for specifying window manager resources is: 

Vuewm [ * scr^ [ * wksp ] [ * comp ] [ * subcomp ] * resource : value 
scr Name of the screen for which the resource is applied. 

wksp Name of the workspace for which the resource is applied. 

comp A vuGwm component: 

Workspace backdrops. 

Client window frames. 

Icons. 

Confirmation and resize boxes. 

Menus managed by vuewm (window 
menu, workspace menu). 

The workspace manager. 

The Workspace Presence dialog box. 

The Rename Workspace dialog box. 

subcomp A subcomponent of a vuewm component: 

title Title bar; subcomponent of client. 

Switch The workspace switch; subcomponent of 

frontPanel. 

The syntax allows you to specify resources that will be applied with 
varying degrees of specificity. Specifically-applied resources override general 
specifications. 



backdrop 

client 

icon 

feedback 

menu 

frontPanel 

workspacePresence 

workspaceController 
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The following examples illustrate applying one particular resource, background, 
to various vuewm components: 
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Vuevnni'backgroiind : blue 
Vuewm^client^background: maroon 
Vuewm*client*title*backgroiind: pink 



Colors all vuewm background 
elements blue. 

Colors client window frames 
maroon. 

Colors the title bar in client window 
frames pink. 



The result of these resources is that the client window frames are maroon and 
title bars in the window frames are pink. All other vuewm backgrounds (for 
example, menus, feedback boxes, icons) are blue. 

Default Screen Names 

When the style manager writes out resources, it uses the following default 
screen names, obtained from the type of display. 

Table 11-1. Default Screen Names. 





High Resolution 


Medium Resolution 


High Color 


HighResHighColor 


MedResHighColor 


Medium Color 


HighResMedColor 


NedResMedColor 


Low Color 


HighResLovColor 


MedResLowColor 


Monochrome 


HighResMono 


MedResMono 
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11 Adding or Deleting Worlcspaces 

The default configuration provides six workspaces. The workspace manager 
provides the ability to rename these workspaces. However, to create or delete 
workspaces, you must use the workspaceList resource. The value of the 
resource is a list containing one or more workspace names separated by spaces. 
Workspace names containing spaces must be quoted. 

For example, the entry: 

Vuewm*workspaceList : Main Remote "project #1" "project #2" 

creates an environment with four workspaces with the specified names. 

Workspace names must be unique — that is, they cannot be the same as any 
client name or class, or any screen name. 



Appearance of Window Frames 

This section describes the resources for changing the following aspects of 
window frame appearance: 

Color The color of foreground, background, top and bottom shadows, 

menus, and dialog boxes. 

Tile The mixture of foreground and background color that 

composes the pattern of the frame surface. 

Font The type style and size used in the title bar, menus, and icon 

labels. 

Components Whether or not to include titlebars, control buttons, resize 
handles, frame mattes, etc. 
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Dynamic Control of Frame Color 

The window manager obtains the colors for the window frames from the 
current color palette. The display components are mapped to palette color sets 
by the following resources: 

Table 11-2. 
Color Set Id Resources Affecting Window Manager Colors. 
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Resource 


Display Component 


Default 
Color Set 


activeColorSetId 


active window frames 


1 


inact iveColorSet Id 


inactive window frames, menus, 
dialog boxes, icons 


2 



The syntax for changing theses resources is: 

f activeColorSetId 1 , 

Vuewm* < . . ^ , ^ ^ , f ' colorset 

[ mactiveColorSetld J 

For example, the resource background, which determines the background color 
of inactive window frames, defaults to the inactive color set. If the inactive 
color set has been assigned to palette color set 5 by the resource: 

Vuewm*inactiveColorSetId: 5 

then the background of inactive window frames is obtained from color set 5 of 
the current color palette. 

Refer to "Mapping Display Components to Color Sets" in chapter 9 for 
additional information. 

Window Frame Color Resources 

The general syntax for explicitly coloring window frames is: 
Vuewm*client*resowrc€: color 
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When you use resources to explicitly color a part of a window frame, that 
component no longer changes color dynamically; the resource specification 
overrides any changes attempted by the style manager. 



Table 11-3. Window Frame Color Resources. 



Resource 


Defmition 


Default 
Color Set 


background 


Background of inactive frames. 


inactive 


topShadowColor 


Left and upper bevel of inactive frames. 


inactive 


bottomShadovColor 


Right and lower bevel of inactive frames. 


inactive 


foreground 


Foreground (title bar text) of inactive 
frames. 


inactive 


activeBackground 


Background of the active frame. 


active 


activeTopShadowColor 


Left and upper bevel of the active frame. 


active 


activeBottomShadovColor 


Right and lower bevel of the active frame. 


active 


activeForeground 


Foreground (title bar text) of the active 
frame. 


active 



For example, the following lines specify frame colors that override the default 
color sets. 

Vuewm*client*activeBackground : MediumBlue 
Vuewm*client*background: SlateBlue 

Window Frame Pixmap Resources 

Pixmaps create shades of colors without adding additional colors to the color 
map. Pixmaps can be used as tiles that provides a visual texture by "mixing" 
the foreground and background colors into a color pattern. 
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Table 11-4. Window Frame Tiling Resources. 



Resource 


Frame Element Tiled 


background? ixmap 


Background of inactive frames. 


bot t omShadowP ixmap 


Right and lower bevels of inactive frames. 


t opShadowP ixmap 


Left and upper bevels of inactive frames. 


act i V eBackgroundP ixmap 


Background of the active frame. 


activeBottomShadovPixmap 


Right and lower bevels of the active frame. 


activeTopShadowPixmap 


Left and upper bevels of the active frame. 
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The following illustration shows the acceptable values for pixmap resources. 
The pixmap is created from a mixture of foreground and background colors. 




I foreground | | background | 25_f oreground 




I 50_foreground "| | 75_f oreground "| I horizQntal_ti le | 




I vertical_tile H j slant_right "| | slant_left ~\ 




riyUic I I- I. vaiiu ■ lie vaiucS. 
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For example, the following lines provide tiling for the inactive windows. 

Vuewni*client*background: White 

Vuewm*client*foreground: Black 

Vuewm*client*backgroundPixmap : horizontal.tile 

Font Resources 

The default font resources for the text of the window manager are set by the 
style manager. You can view the current value by executing: 

xrdb -q | grep fontList 

Additional default font (fontList) resouces are provided in 
/usr/lib/Xll/app-defaults/Vuewm. 

Use the fontList resources to override the default fonts. The resources can use 
any valid font name as its value. 

For example, the resources: 

VTiemii*icon*fontList: coiirB12 

VueBiii*HighResHighColor*frontPanel*Tueinndate*f ontListl : courBlS 

causes the window manager to use the font with font alias courB12 for icons, 
and courBlS for the first line of the date in the workspace manager. 

Refer to the vuewm(lX) man page for additional information about font 
resources. 

Specifying the Components of the Window Frame 

The window manager has two resources for customizing the contents 
(decoration) of the window frame. 

Table 11-5. Window Frame Decoration Resources. 



Resource 


Description 


clientDecoration 


The decoration for client window frames. 


trsoisientDecoration 


The decoration for frames around transient windows 
(secondary windows — ^for example, dialog boxes.) 
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Functionality provided by decoration that has been removed can still be 
accessed by binding its functions to mouse buttons or key presses. 

The syntax for the clientDecoration resource is: 
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Vuewm 



*< 



' clientname ' 
clientclass 
defaults 



*clientDecoration: list 



The syntax allows you to specify decoration for particular instances or classes 
of clients. The defaults reserved word is used to specify decoration for clients 
of unknown class. 

The syntax for the transientDecoration resource is: 

Vuewm*tr ans ientDecor at ion : list 
The value of the resources, list, is a list of frame elements. It has the syntax: 

ran I 

[ none J 
iborder 
^maximize 
iminimize 
iresizeh 
±menu 
ititle 
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Table 11-6. Window Frame Elements. 



Frame Element 


Description 


all 


Include all frame elements (default value). 


border 


Window border. 


maximize 


Maximize button (includes title bar). 


minimize 


Minimize button (includes title bar). 


none 


Include no window frame elements. 


resizeh 


Resize border handles (includes border). 


menu 


Window menu button (includes title bar). 


title 


Title bar. 



Window i:f^. 

Menu 



X 



Title Bar 



"'Vl'llBii™')!;?'!!?!' 



Top shadow color ' 



>TennlnafWindow 



— Maximize 
"^ Minimize 



SaSagiPggglMigi>l»^ ^^ 



' — Resize Border 



s^gig^gg^^^g^aga^^g^M^Pii' 



Top shadow 
color 



Bottom shadow color 



Figure 11-2. Frame Elements. 



If the first element in the list is preceded by a plus (+) sign or no sign, the 
workspace manager starts with no frame elements and adds the elements in the 
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list. If the list begins with a minus (— ) sign, the window manager starts with a 
complete frame and subtracts the elements in the list. ' ' 

For example, to rem.ove the maximize button and resize handles from all client 
windows, use: 

Vuewm*clientDecoration: —maximize— res izeh 

To specify a border with only a title bar and window menu button around a 
particular xterm window started as xterm -name pronto, use: 

Vuewm*pronto*clientDecorat ion : +menu 

Specifying Resources for the Frame Title Bar 

Resources can be specified separately for the title bar using the syntax: 

Vuewm*client*title*re50wrce: value 

For example, the following resource specifies a pink title bar for the active 
background of all client windows. 

Vuewm*client*title*activeBackground: pink 

Matting Clients 

A matte is a 3-D border just inside the window between client area and 
window frame. The syntax for specifying mattes is: 



Vuewm 



*< 



' clientname ' 
clientclass 
defaults 



*MatteResource: value 
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Table 11-7. Matte Resources. 



Resource 


Description 


Default Value 


matteVidth 


Width of the matte. 


(no matte) 


matt eBackground 


background color. 


vuewm background 


matteTopShadowColor 


Left and upper bevel colors. 


Lightened 

matt eBackground color. 


matteBottomShadowColor 


Right and lower bevel 
colors. 


Darkened 

matt eBackground color. 


matteForeground 


Matte foreground color. 


Darkened 
matteBottomShadowColor. 


matt eBo 1 1 omShadowP ixmap 


Right and lower bevel 
tiling. 


Client bottom shadow color 


matteTopShadowPixmap 


Left and upper bevel tiling. 


Client top shadow color 



For example, the following line creates a 10-pixel- wide LightBlue matte for a 
particular xterm window started as xterm -name scribe. 

xterm*scribe*inatteWidth: 10 

xterm*scribe*matteBackground : LightBlue 
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VuGwm* < 



y* resource: value 



Appearance of Particular Components 

You can specify the appearance of particular objects managed by the window 
manager using the syntax: 

menu 
icon 
client 
backdrop 
feedback 
Switch 

workspaceController 
^ workspacePresence 

For example, the following lines specify background colors for the window 
manager menus and for the workspace presence dialog box. 

Vuewm*menu*background: SkyBlue 

Vuewin*workspacePresence*background : MediumBlue 

The backdrop resources apply to a specific workspace. See "Workspace 
Backdrops" later in this chapter for additional information. 
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Customizing Icons 

This section covers: 

■ The graphical parts of an icon. 

■ Changing the appearance and placement of icons. 

■ Using an iconbox to hold icons. 
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Parts of an Icon 

Icons have two parts (decorations) — a text label and a graphics image. 



frame 
image 

label 

Figure 11-3. Graphical Components of an icon. 




icon Labei 



The label is usually supplied by the client (via the WM_ICON_NAME window 
property). Some clients provide a command-line option for changing the label. 
Icon labels are truncated on the right to the width of the icon image. 
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Icon Image 

An icon image is a pixmap. It is supplied by one of several sources, listed in 
the order of precedence: 

■ A user- supplied supplied image by means of the iconlmage resource. 

■ A client- supplied icon image — an icon window or a bitmap — supplied by the 
client through the 'WM_HINTS" window property.) 

■ A built-in default icon image supplied by vuewm. This image is used if 
neither the user nor the client specifies an icon image. 

The resource useClientlcon interchanges the precedence of user- supplied icon 
images and client-supplied icon images. The default value is "False." When 
the resource is set to "True," client-specified icon images have precedence over 
user- supplied icon images. 

Specifying the Icon Decoration 

Use the iconDecoration resource to select the parts of an icon to be displayed: 

Table 11-8. The Values That Control Icon Decoration. 
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Appearance 


Resource Value 


Label only. 


label 


Image only. 


image 


Both label and image. 


label image 


An untruncated active label. 


label activelabel 



Dynamic Colors for Icons 

The default color for icon backgrounds comes from the color set specified by 
the inactivGColorSetId resource. Thus, icons are the same color as inactive 
window frames. 
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11 Coloring and Tiling Icons 

The resources that control icon color and tile have the syntax: 



Vuewm 



*< 



' cUentclass 
clientname 
default 



* resource: value 



Table 11-9. Coloring Icons with Window Manager Resources. 



Resource 


Description 


iconlmageBackground 


Icon image background. 


iconlmageTopShadowColor 


Left and upper bevel of icon image. 


iconlmageBottomShadowColor 


Right and lower bevel of icon image. 


iconlmageForeground 


Icon image foreground color. 


iconlmageBottomShadowPixmap 


Tiling of right and lower bevels of an icon 
image. 


iconlmageTopShadowPixmap 


Tiling of left and upper bevels of an icon 
image. 



Icon Frames 

The syntax for changing the appearance of the frame elements of icons is: 

Vuewm* i con* resowrce: value 
For example, the following line changes the font used in the icon label: 
Vuewm*icon*fontList: courB012 
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Organization of Icons 

There are two ways to organize icons: 

■ Stand-alone icons. These icons do not use an icon box. This is the default 
configuration. 

■ In an icon box. 

The choice of organization is persistent across workspaces. Thus, if you choose 
to use the icon box, it will be present in all workspaces. 

Stand-Alone Icons 

Resources control where icons are placed on the screen and their size. 
Icon Placement. The resources that place icons have the syntax: 

Vuewm* resource : value 

You can have the window manager place the icons according to a scheme you 
specify, or you can place the icons yourself. 

Table 11-10. Icon Placement Resources. 
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Resource 


Description 


Default 


iconAutoPlace 


Determines whether the window 
manager automatically places 
icons. 


True 


iconPlacement 


A placement scheme for icons 
when iconAutoPlace is "True." 


left top 


iconPlacementMargin 


The distance between screen 
edge and icons when 
iconAutoPlace is "True." 


The default 
space between 
icons 
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The iconPlacement resource can have these values: 

Table 11-11. Schemes for Automatic Placement of Icons. 



Placement Scheme 


Resource Value 


Left to right, top of the screen. 


left top 


Right to left, top of the screen. 


right top 


Left to right, bottom of the screen. 


left bottom 


Right to left, bottom of the screen. 


right bottom 


Bottom to top, left side of the screen. 


bottom left 


Bottom to top, right side of the screen. 


bottom right 


Top to bottom, left side of the screen. 


top left 


Top to bottom, right side of the screen. 


top right 



For example, to specify automatic placement of icons starting at the top of the 
screen and proceeding down the right side, use: 

Vuewm+iconAutoPlace: True 
VuGwm+iconPlacement: top right 

Icon Size. Icon images have a default maximum and minimum size. The size 
limits can be changed to other values within the allowable bounds. 

Table 11-12. The Maximum and Minimum Sizes for Icon Images. 





Maximum Size 


Minimum Size 


Default 


50x50 pixels 


32x32 pixels 


Allowable 


128x128 pixels 


16x16 pixels 
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The maximum and minimum sizes are changed with these resources: 

Table 11-13. 
Controlling Icon Image Size with Window Manager Resources. 



Resource 


Description 


i c onlmag eMax imum 


Maximum size of an icon image. 


i conlmageNinimum 


Minimum size of an icon image. 
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Using the Icon Box 

The icon box is a scrollable window containing an icon for every client window 
in the current workspace that can be iconified. The icons of normalized 
windows are visually distinct from icons of minimized windows. 



i— Location cursor 



A 



...$<i!Of**_ 




Maa 




Styte 






I— Irnn 



/ - 



Icon for noHDalized window 
' — icon for iconified window 

Figure 11-4. A Horizontal Icon Box. 
Specifying Use of the Icon Box. There are two ways to specify the use of an 
icon box: 

■ Set the uselconBox resource is set to "True." 

■ Edit the FrontPanel section in $HOME/ . vue/vuewmrc: 

1. Uncomment the line for the vuewmbox control. 

2. Comment the second vuewmrib control. 
The lines in vuewmrc will look like this: 



# vuewmrib 
vuewmbox 



[N] =65 

[P] Qiconbox.l.bm =65 
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Orientation and Size of the Icon Box. By default, the icon box is oriented 
vertically. Several resources specify the geometry and general appearance of the 
icon box. 



Table 11-14. Icon Box Appearance Resources. 



Resource 


Description 


iconBoxGeometry 


Size and placement of the icon box. 


iconBoxSBDisplayPolicy 


Whether the icon box has only horizontal or vertical 
scrollbars, or both. 


iconBoxTitle 


Title appearing in the titlebar. 



The value of the iconBoxGeometry resource is a standard window geometry 
string with the syntax: 

= Widthx Height[ ±x±y] 

where width and height are in units of icons. The actual size of the icon 
box window depends on the iconlmageMaximum (size) and iconDecoration 
resources. 

Table 11-15. Values for the IconBoxSBDisplayPolicy Resource. 



Value 


Effect 


vertical 


Displays vertical scrollbar and sets the icon box orientation to 
horizontal. 


horizontal 


Displays horizontal scrollbar and sets the icon box orientation to 
vertical. 


all 


Displays horizontal and vertical scrollbars. The largest dimension of 
the iconBoxGeometry resource determines whether the icons are 
placed in a row or a column. 



Appearance and Behavior of Icons in the Icon Box. Two resources determine 
the appearance of icons in the icon box: 
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Table 11-16. icon Behavior in tiie icon Box. 



Resource 


Description 


iconDecoration 


Determines icon components — label, image, or both (see 
"Specifying the Icon Decoration" in this chapter). 


fadeNoziDallcon 


Icons for normal windows are grayed-out. The default is 
"False." 
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IMinimizing tiie Icon Box. There are two ways to temporarily remove the icon 
box from the display: 

■ If the workspace manager contains the vuewmbox control, use the system 
menu button to "close" the icon box. Click the vuewmbox control to redisplay 
it. 

■ If there is no vuewmbox control in the workspace manager, the icon box will 
contain a minimize button to iconify the icon box. 

Otiier Icon Box Resources. The iconBoxName resource specifies the name 
that is used to look up client-specific icon box resources. The default name is 
"iconbox." 

The syntax for icon box resources is: 

Vuewm* iconboxname* resource : value 

You can use vuewm resources dealing with frame decoration and icon 
appearance. The icon appearance resources aifect the icon displayed when the 
icon box is minimized. 

For example, the following line specifies that a bitmap file named icons be 
used when the icon box is iconified. 

Vuewm*iconbox*iconImage : $HOME/bitmaps/icons 
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^^ Using Custom Pixmaps For Icons 

When you iconify a client, either the client supplies its own icon image, the 
window manager supplies a default image, or you supply an image of your 
own — one you obtain "ready-made" or one you create using the 'bitmap' client. 

There are two resources that tell the window manager where custom icons are 
located: 

■ The iconlmage resource specifies the bitmap for a particular icon image. Its 
value is the path to the file containing the bitmap. Note that, if specified, 
this resource overrides any client-specified image. 

■ The bitmapDirectory resource causes the window manager to search the 
specified directory whenever a bitmap is named with no complete path. The 
default value for bitmapDirectory is /usr/include/Xll/bitmaps. 

The syntax for specifying these resources is: 
Vuewm*bitmapDirectory: directory 



Vuewm* 



' clientclass 
clientname 
defaults 



* i conlmage : path/bitmap 



For example, the following lines specify a custom bitmap for all emacs client 
windows, and two different bitmaps for two xterm windows named terml and 
term2. All the custom files are in directory $HOME/bitmaps. 

Vuewm*bitmapDirectory : $HOME/bitmaps 

Vuewm*emacs*iconImage: quill 

Vuewm*terml* iconlmage: star 

Vuewm* term2* iconlmage: square 
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Workspace Backdrops 

This section covers: 

■ How the window manager obtains backdrop images (bitmaps). 

■ How to change backdrop colors from their default values. 

Backdrop Images 

The workspace backdrops shipped with HP VUE are a collection of bitmap files 
located in the directory /usr/lib/Xll/bitmaps/Vuebackdrops. Files in this 
directory are listed in the style manager's Backdrop dialog box. 
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Figure 11-5. The Backdrop Dialog Box. 
Changing the Backdrop Directory 

Use the style manager resource backdropDirectory to change the directory 
the style manager uses to locate the backdrop files. Use the syntax: 

VuestylG*backdropDirGctory : path/ directory 
The value of the resource must be an absolute path. 
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Associating Bacl(drops With Woricspaces 

The following resource associates a backdrop with a workspace: 

Vuewm [ * screen ] * workspace*\> ackdr op * image : fi bitmap^file 

where bitmap-file is the absolute path of the bitmap. 

For example, the following line specifies the backdrop for a workspace named 
"Mail": 

Vuewm*Mail*backdrop* image: \ 

®/usr/lib/Xll/bitmaps/Vuebackdrops/Squids 

Displaying ttie Root Window in a Workspace 

The workspace backdrops overlay the root window. To turn off the backdrop in 
a particular workspace, use the image resource as follows: 

Vuewm [* screen] *ii;or^5pace*b ackdr op* image : none 
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Adding Custom Backdrops 

11 

If you have root permission, you can add a backdrop by simply adding a 

bitmap file to /usr/lib/Xll/bitmaps/Vuebackdrops. 

The following procedure allows users who lack permission to write to the 
default backdrop directory to create and use their own bitmaps: 

1. Create a directory for the backdrops bitmaps. 

2. Use the backdropDirectory resource to specify this directory. For example, 
if the directory is $HOME/.vue/backdrops, then add: 

Vuestyle*backdropDirectory : $HOME/ . vue/backdrops 

to the resource database. 

3. Create a symbolic link between the new directory and the backdrops 
shipped with HP VUE by executing: 

In -f -s /usr/lib/Ill/bitmaps/Vuebackdrops/* $HOHE/.Tue /backdrops 

This links all the files in the default directory with the new directory. 

4. Create the bitmap files for the new backdrops. Put them in the new 
directory. 

The new backdrops appear in the style manager Backdrop dialog box at the 
next session. 
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Combining a Bitmap image With tlie ''Deep" Backdrop 

The "deep" backdrops are the backdrops that appear as stacked rectangles 
with different gradations of the same color. 

Yon can create a deep backdrop containing a bitmap image in the center by 
using the naming convention deepbitmap^file for the bitmap file name. For 
example, if you've added a bitmap named Yogurt to the backdrop directory, 
the resource: 

Vuewm*Printing*backdrop* image : ©deep Yogurt 

creates a deep backdrop for the workspace named Printing containing the 
Yogurt bitmap in the center. 

Backdrop Colors 

This section describes: 

■ How HP VUE generates the default backdrop colors. 

■ How to change the color sets used for the backdrops. 

■ How to specify specific colors for backdrops. 
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Default Colors 

The colors of the backdrops are obtained from the color sets in the current 
palette: 

■ For high color displays, the workspaces are assigned color sets in reverse 
order — that is, workspace #1 uses color set 8, workspace #2 uses color set 7, 
etc. The active and inactive color sets (by default, color sets 1 and 2) are not 
used as backdrop colors (a seventh workspace reuses color set 8). 

■ For medium color displays, all backdrops use the secondary color set (by 
default, color set 4). 

■ For low-color and monochrome displays, all backdrops use the inactive color 
set (by default, color set 2. 

Two colors are used from each color set — the topShadowColor is used for 
the image background and the bottomShadowColor is used for the image 
foreground. 
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Figure 11-6. Color Sets Used for Backdrops on a High Color Display. 
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Changing the Color Sets Used for Backdrops 

The colorsetid resource specifies which color set is used for a particular 
workspace. It has the syntax: 

Vuewm[ * screen] *u;orA;space*backdrop*colorsetId: colorset 

For example, the following line causes the workspace named "Graphics" to use 
color set 1. 

Vuewni*Graphics*backdrop*colorsetId: 1 

Explicitly Setting the Backdrop Colors 

You can use resources to explicitly specify the foreground and background color 
of backdrops. Colors specified this way cannot be changed dynamically. 

Vuewm[ * screen] * iyorA:space*b ackdr op *resowrce : color 
Table 11-17. Backdrop Color Resources. 



Resource 


Description 


imageBackgroiind 


Sets the backdrop background color. 


imageForegro\md 


Sets the backdrop foreground color. 



For example, the following lines create a violet and black backdrop for the 
workspace named "Printing" , regardless of the current palette. 

Vuewni*Printing*backdrop*imageBackgroxmd : violet 
Vuewm*Printing*backdrop*imageForeground : black 
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Customizing the Root Window with 'xsetroot' ^^ 

In HP VUE, the root window is the window behind the workspace backdrops. 
Ordinarily, the root window is completely obscured by the backdrops. However, 
the Vuewm*backdrop* image resource allows you to specify that no backdrop 
be used for one or more workspaces, thus allowing the root window to show 
through. 

For example, the following resource specifies no backdrops for the workspace 
named Testing. 

Vuewm*Testing*backdrop*image: none 



Changing the Workspace Cursor 

The workspace cursor appears when the pointer is elsewhere than a client 
window. The xsetroot client lets you change the bitmap used for the root 
window cursor. For example, the following command changes the workspace 
cursor using two custom bitmaps located in directory $HOME/bits. 

xsetroot -cursor "/bits/shuttle.bm " /bits /mask. bm 
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11 Window Manager Functions 

The window manager functions can be accessed with button bindings, key 
bindings, or by window manager menus. 

Functions may be constrained by: 

■ The contexts in which the function can operate: 
Root Root window is selected. 

Icon Icon is selected. 

Window Client window is selected. Some functions operate only when 

the window is in its normalized state (f. maximize), or its 
maximized or iconified state (f. normalize). 

■ Which devices (resources) can specify and invoke the function: 
Button Button binding (mouse). 

Key Key binding. 

Menu window manager menu. 

Any selection that uses an invalid context, an invalid function, or a function 
that doesn't apply to the current context is grayed out. This is the case with 
the "Restore" selection of a terminal window's window menu or the "Minimize" 
selection of an icon's window menu. 
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Table 11-18. Window Manager Functions. 



Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f. action 


Invokes the specified 
action. 


V 


V 


V 


V 


V 


V 


f.beep 


Sounds a tone. 


V 


V 


V 


V 


V 


V 


f.circle_down 


Puts window on 
bottom of stack. 


V 


V 


V 


V 


y 


y 


f.circle_up 


Puts window on top of 
stack. 


V 


V 


V 


V 


V 


V 


f.exec 


Uses /bin/sh to 
execute a command. 


V 


V 


V 


V 


V 


V 


f.focus-color 


Sets colormap focus 
when colormap focus 
policy is explicit. 


V 


V 


V 


V 


V 


V 


f.focus_key 


Sets keyboard input 
focus when keyboard 
focus policy is explicit. 


V 


V 


V 


V 


V 


V 


f.kill 


Terminates a client's 
connection to server. 




V 


V 


V 


V 


V 


f. lower [—client] 


Lowers a window to 
bottom of stack. 




V 


V 


V 


V 


V 


f.maximize 


Enlarges a window to 
its maximum size. 




V 


V 


V 


V 


y 


f.menu 
[menuname] 


Associates a menu with 
a selection or binding. 


V 


V 


V 


V 


V 


v 


f.minimize 


Changes a window into 
an icon. 






V 


V 


V 


V 


f.move 


Enables the interactive 
moving of a window. 




V 


V 


V 


V 


V 



Tlie Window IManager 11-33 



Table 6- 17a. Valid Window Manager Functions (continued). 




Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f.next-cmap 


Installs the next 
colormap in the 
window with the 
colormap focus. 


a/ 


y 


y 


V 


a/ 


y 


f.next_key 
[icon 1 window 
1 transient] 


Sets keyboard focus 
policy to the next 
window/icon in the 
stack. 


V 


V 


y 


y 


V 


y 


f. next -work- 
space 


Switches to the next 
workspace. 


y 


V 


^/ 


V 


y 


y 


f.nop 


Does no function. 


^/ 


y 


>/ 


V 


x/ 


V 


f.normalize 


Normalizes a window. 




y 


y 


V 


y 


y 


f.normalize_ 
and_raise 


Normalizes and raises 
a window (if 
raiseKeyFocus is 
"True"). 




V 


y 


y 


V 


x/ 


f.occupy_all 


Makes a window 
persistent across all 
workspaces. 




y 


yf 


v 


y 


V 


f.pack_icons 


Packs icons rows in the 
workspace window or 
icon box. 


y 


x/ 


>/ 


y 


y 


x/ 


f.pass_keys 


Toggles between 
enabling and disabling 
processing of key 
bindings. 


y 


y 


y 


^ 


x/ 


y 


f.post_wmenu 


Posts the window 
menu 


V 


V 


%/ 


^ 


v 
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Table 6- 17b. Valid Window Manager Functions (continued). 




Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f.prev_cmap 


Installs the previous 
color map in the 
window with the 
colormap focus. 


V 


V 


y/ 


v 


x/ 


y 


f.prev_key 
[icon 1 window 
1 transient] 


Sets the keyboard 
input focus to the next 
window /icon in the 
stack. 


v 


V 


V 


V 


V 


y 


f.pre- 

vious_work- 

space 


Switches to the 
previous workspace. 


V 


V 


V 


V 


v 


>/ 


f.quit_mwm 


Terminates the window 
manager without 
exiting the session. 


V 






V 


sj 


y 


f.raise 
[— cJient] 


Lifts a window to the 
top of the window 
stack. 




V 


V 


V 


V 


a/ 


f.raise_lower 


Raises a partially 
concealed window; 
lowers an unconcealed 
window. 




V 


V 


V 


y 


a/ 


f.refresh 


Redraws all windows. 


V 


V 


V 


v 


y/ 


V 


f.refresh_win 


Redraws a client 
window. 






V 


V 


V 


V 


f. remove 


Removes client window 
from current workspace 




V 


V 


V 


V 


y 


f.resize 


Enables you to 
interactively resize a 
window. 






V 


V 


V 


y 
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Table 6- 17c. Valid Window Manager Functions (continued). 




Functions 


Contexts 


Devices 


Name 


Description 


Root 


Icon 


Window 


Button 


Key 


Menu 


f.restart 


Restarts the window 
manager. 


V 






V 


y 


V 


f.send_msg 

messagenum- 

ber 


Sends a client message. 




V 


V 


V 


V 


V 


f.separator 


Draws a line between 
menu selections. 


V 


V 


V 






V 


f.set-behavior 


Restarts vuewm with 
CXI or custom 
behavior. 


V 


V 


V 


V 


V 


V 


f.title 


Inserts a title into a 
menu at the specified 
position. 


V 


V 


y/ 






V 


f.toggle_front- 
panel 


Minimizes the front 
panel. 


V 


V 


V 


V 


V 


V 


f. work- 
space-presence 


Displays the 
Workspace Presence 
dialog box. 






V 


V 


V 


V 


f. work- 
space-rename 


Displays the Rename 
Workspace dialog box. 


V 


V 


V 


V 


V 


V 
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Window Manager Menus 

Th.e window manager menus are defined in the window 
manager configuration file (typically, $HOME/.vuG/vuGwmrc or 
/usr/lib/Xll/vue/Vuewm/sys.vuewmrc). 
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Menu Syntax 

Window manager menus have the syntax: 



Menu MenuName 

i 

selectionl [.mnemonic] 
selection2 [.mnemonic] 
selections [mnemonic] 



[accelerator] function [argument] 
[accelerator] function [argument] 
[accelerator] function [argument] 



selection* [mnemonic] [accelerator] function [argument] 

y 

The order of the selections is the order of their appearance in the menu. Any 
character string containing a space must be enclosed in double quotes. 

A selection name can be a character string or a bitmap. The syntax for using a 
bitmap is: 

^/ path/ bitmapfile function [argument^ 
A mnemonic is specified using the syntax: 

mnemonic = ^character 

An accelerator is specified using keyboard binding syntax described later in this 
chapter (see "Keyboard Binding Syntax"). 
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1^ Default Menus 

The window manager has two default menus: 

■ The workspace menu. The HP VUE default button bindings display it by 
pressing buttons 1 or 3 on the workspace window. This menu is also called 
the "root" menu. 

■ The window menu. The default window menu is built into vuewm. For 
reference, a copy of its contents are placed in sys.vuewmrc. A built-in 
button binding displays it by pressing button 1 on a frame's window menu 
button. An additional default HP VUE button binding displays it by 
pressing button 3 anywhere on a window frame. 

You can modify either menu. However, for consistent window operation, it's 
usually better to modify only the workspace menu. 

Changing the Menu Associated with the Window Menu Button 

The windowMenu resource specifies the menu displayed when you press button 1 
on the window menu button. It has the syntax: 



Vuewm* 



' clientname ' 
clientclass 
defaults 



♦windowMenu : MenuName 



For example, the following line associates a menu named EditMenu with an 
xterm window started as xterm -name editor. 

Vuewm*editor*windowMenu: EditMenu 



Changing the Workspace Menu 

The default workspace (root) menu is bound to mouse buttons 1 and 3 by the 
button bindings: 

<BtnlDown> root f .menu VueRootMenu 

<Btn3Down> root f .menu VueRootMenu 

To use a different menu, replace VueRootMenu with the name of another menu 
in the vuewmrc file. 
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Making Other New Menus ^^ 

You can create completely new menus that are displayed by: 

■ Key presses. You must provide a key binding for the menu. 

■ Button presses. You must provide a button binding for the menu. 

■ Cascading the menu from another menu. For example, the following 
workspace menu entry, when selected, displays the menu named 
Remote.Hosts. 

"Remote Hosts" f .menu Remote.Hosts 



Button Bindings 

A button binding associates a button operation with a window manager 
function. Button bindings persist across all workspaces. 

The window manager recognizes these button operations: 

Press Holding down a mouse button. 

Click Pressing and releasing a mouse button. 

Double-click Pressing and releasing a mouse button twice in rapid 
succession. 

Drag Pressing a mouse button and moving the pointer (and mouse 

device). 

You should not bind the same button to different functions for the click 
and press operations. For example, you should not bind <BtnlClick> and 
<BtnlDown> to different functions. 
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^^ Button Binding Syntax 

The syntax for button bindings is: 

Buttons ButtonBindingSetName 

i 

button context \ context function [.argument'] 

button contextl context function laryumenf] 

button context \ context function largument'] 

y 

The context indicates where the pointer must be for the binding to be effective. 
The following are valid contexts: 

root Workspace window. 

window Client window or window frame. 

frame Window frame. 

icon Icon. 

title Title bar. 

app Client window (excludes the window frames). 

You should avoid binding more than one function that changes window or 
window manager state, or that posts a dialog box or menu, to the same button 
and context. 
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Default Button Bindings 

The window manager has the following built-in button bindings. 
Table 11-19. Built-in Button Bindings. 
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Location of Pointer 


Behavior 


Window menu button 


Pressing button 1 displays the window menu. This 
behavior can be modified by the wMenuButtonClick 
resource. 


Window menu button 


Double-clicking button 1 closes the window. This 
behavior can be modified by the wMenuButtonClick2 
resource. 


Minimize button 


Clicking button 1 minimizes the window. 


Maximize button 


Clicking button 1 maximizes the window. 


Title bar 


Dragging button 1 moves the window. 


Window or icon 


Pressing button 1 gives it keyboard focus. 


Resize border 


Dragging button 1 resizes the window. 


Icon 


Clicking button 1 displays the icon window menu. This 
behavior can be modified by the iconClick resource. 


Icon 


Double-clicking button 1 normalizes the window. 


Icon 


Dragging button 1 moves the icon. 



These bindings are fixed — they cannot be deleted or replaced by other 
bindings. However, you can add to some of them (see "Modifying Button 
Bindings and Their Functions.") For example, you can specify an additional 
function for double-clicking button 1 in an icon, but the double click will also 
normalize the window. 
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Tlie sys . vuewmrc file contains these additional HP VUE bindings that can be 
deleted or replaced. They are located in vuewmrc in the button binding set 
named VueButtonBindings. 



Table 11-20. Additional HP VUE Button Bindings. 



Button Binding 


Description 


<BtnlDovn> root f .menu VueRootHenu 


Pressing button 1 on the 
workspace window displays the 
workspace (root) menu. 


<Btn3Down> root f .menu VueRootMenu 


Pressing button 3 in the 
workspace window displays the 
workspace (root) menu. 


<BtnlDown> frame! icon f. raise 


Pressing button 1 on a frame or 
icon raises it to the top of the 
stack. 


<Btn3Down> frame 1 icon f.post_wmenu 


Pressing button 3 on a frame or 
icon displays the window menu. 


Meta<6tnlDown> icon I window f.move 




Pressing [Alt] ((Extend char)) and 
dragging button 1 on an icon or 
window moves the window. 


Meta<Btn3Down> window f. minimize 




Pressing [Alt J ((Extend char J) and 
button 3 on a window minimizes 
the window. 
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Modifying Button Bindings ^^ 

Button bindings can be modified by: 

■ Editing the VueButtonBindings in vuewmrc. 

■ Making a new button binding set. 
To create a new button binding set: 

1. Edit vuewmrc to include a new key binding set with a unique 
ButtonBindingSetName . 

2. Set the buttonBindings resource to the new ButtonBindingSetName. 
For example, here is a new button binding set: 

Buttons GraphicsButtonBindings 

<Btn2Down> root f .menu "Graphics Project" 
> 

The following resource makes the new set active. 

Vuewm*buttonBindings : GraphicsButtonBindings 



Key Bindings 

You can bind window manager functions to "special" keys using keyboard 
bindings. The window manager recognizes the following special keys: 

■ Shift. 

■ Escape. 

■ Alt (Meta or Extend Char). 

■ Tab. 

■ Ctrl. 

■ Lock. 
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^^ Keyboard Binding Syntax 

The syntax for keyboard bindings is: 

Keys KeyBindingSetName 

i 

key context\ context function {.argument] 

key context] context function iargumenf] 

key context] context function Iargumenf] 
> 

The first line specifies the function type (Keys) and the name of the keyboard 
binding set. 

The remaining lines specify the actual keyboard bindings. Each line identifies a 
unique key press sequence. The context indicates what element(s) must have 
keyboard focus for the binding to be active: 



root 


Workspace window 


window 


Client window. 


icon 


Icon. 
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Default Key Bindings 

The window manager has the following HP VUE default key bindings. 
Table 11-21. HP VUE Window Manager Keyboard Bindings. 
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When the keyboard 
focus is: 


Press: 


Effect: 


Icon, window, or 
none 




Toggles the workspace manager between 
iconified and restored state. 


(Alt I Menu r 


Window or icon 




Displays window menu. 


(Shift) (Escape] 


Window or icon 




Displays window menu. 


(Alt) (space) 


Window, icon, or 
none 


(Alt) (Tab) 


Switches keyboard focus to the next 
window or icon. 


Window, icon, or 
none 


(Alt) (Shift) (Tab) 


Switches keyboard focus to the previous 
window or icon. 


Window, icon, or 
none 




Switches keyboard focus to the next 
window or icon. 


(Alt) (Escape) 


Window, icon, or 
none 




Switches keyboard focus to the previous 
window or icon. 


(Alt) (Shift) (Escape) 


Icon, window, or 
none 


(MD 


Puts the top window on the bottom of 
the stack. 


Icon, window, or 
none 


(MD 


Puts the bottom window on the top of 
the stack. 


Window 


(Alt)(F6) 


Switches keyboard focus to the next 
transient window in an application. 


Window, icon, or 
none 


(Alt) (Ctrl) (Shift) m 


Restarts vuewm with default HP/OSF 
Motif or custom behavior. 



1 For the HP C1429A Enhanced Vectra keyboard, use [AltXPrint Screen) . For keyboards with a 
(Pop) key, use (AltlPop) . 



The Window i\/lanager 11-45 



The HP VUE default bindings are specified in sys.vuewmrc. To see them, 
* ' search the file for this portion of the file: 

Keys VueKeyBindings 
-C 

list of key bindings 
} 



Modifying Key Bindings 

Key bindings can be modified by: 

■ Editing the VueKeyBindings in vuewmrc. 

■ Making a new key binding set. 
To create a new key binding set: 

1. Edit vuewmrc to include a new key binding set with a unique 
KeyBindingSetName . 

2. Set the keyBindings resource to the new KeyBindingSetName. 
New key bindings take effect when the window manager is restarted. 
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Controlling Window Size and Placement 

The window manager has several resources that allow you to refine your control 
of the size and placement of windows. 

Table 11-22. Refining Control with Window Manager Resources. 
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Resource 


Description 


Default 


interact ivePlacement 


Lets the user position new 
windows interactively. 


False 


limitResize 


Lets the user enlarge windows 
beyond the 
maximumClientSize. 


False 


max imumNax imumS iz e 


Maximum size of a client 
window set by user or client. 


2 X screen 


moveThreshold 


Number of pixels the pointer 
must move before a move 
operation is started. 


4 pixels 


positionlsFrame 


Position information refers to 
the window frame rather than 
the window. 


True 


po s it i onOnS ere en 


When "True," positions new 
windows so that they are not 
clipped by the screen edges. 


True 


resizeBorderVidth 


Width of the frame's resize 
border. 


10 pixels 


resizeCursors 


Whether or not a resize cursor 
is displayed in a resize border. 


True 


maximumClientSize 


Maximum size of a maximized 
client. 


screen size 
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All the resources that refine control over the size and placement of windows, 
except maximumClientSizG, have the following syntax: 

Vuewm* resource : value 
The maximumClientSize resource has the syntax: 

' clientname ^ 
Vuewm* < clientclass > .maximumCliGntSize: widthxheight 
defaults J 



Setting Focus Policies 

The window manager focus policies control the arbitration of resources among 
clients by determining what happens when a window becomes the active 
window. 

Table 11-23. Focus Policy Resources. 



Resource 


Description 


Default Value 


colormapFocusPolicy 


Specifies which window has 
the colormap focus. 


keyboard 


keyboardFocusPolicy 


Specifies which window has 
the keyboard and mouse 
focus. 


explicit 
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These values are valid for the colormapFocusPolicy resource: 

keyboard The window manager tracks keyboard input and installs a 

client's colormap when the client window gets the keyboard 
input focus. 

pointer The window manager tracks the pointer and installs a client's 

colormap when the pointer moves into the client window or the 
window frame around the client. 

explicit The window manager tracks a specific focus-selection operation 

and installs a client's color map when the focus-selection 
operation is done in the client window. 

These values are valid for the keyboardFocusPolicy resource: 

pointer The window manager tracks the pointer and sets the keyboard 

focus to a client window when the pointer moves into that 
window or the window frame. 

explicit The window manager tracks a specific focus-selection operation 

and sets the keyboard focus to a client window when the 
focus-selection operation is done in that client window. 

For example, the following line changes the keyboard focus policy: 

Vuewm*keyboardFocusPolicy : pointer 

When the keyboard focus policy is explicit, the passSelectButton 
resource specifies the consequence of the focus- selection operation. When 
passSelectButton is "True" (the default value), the focus-selection operation 
is passed to the client or is used by the window manager to perform some 
action; when passSelectButton is "False," the focus-selection operation is 
used only to select the focus and is not passed. 
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11 Switching Between Default and Custom Behavior 

The window manager has a built-in key binding that allows you to switch back 
and forth between customized vuewm behavior and default OSF/Motif behavior. 
The key presses for doing this are (Alt] (shift) (Ctrl) Q. 

Switching to the default behavior has these effects: 

■ The workspace manager is removed. 

■ Custom key and button bindings are removed. 



Using the Window Manager with Multiple Screens 

By default, the window manager manages one screen. Managing multiple 
screens can be specified in two ways: 

■ Using resources. 

■ By editing the startup command for vuewm. 

When vuewm manages more than one screen, it tries to create at least one 
workspace on each screen. 

Using Resources to Manage Multiple Screens 

The following resources configure the window manager to manage multiple 
screens: 

■ To specify that vuewm manage multiple screens, use the resource: 

Vuewm*multiScreen: True 

This tells the window manager to try to manage all screens that the server 
manages. 

■ Use the vuewm resource screenList to define the screen names. For example, 
the following resource names two screens zero and one. 

Vuewm*screenList : zero one 
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Specifying Multiple Screens from the Command Line ^^ 

The the session manager resource wmStartup command lets you specify a 
different command line for starting the window manager. You can use 
command-line options to start vuewm so that it manages multiple screens: 

■ The -display option specifies the display. It has the syntax: 

-display hostname: display . screen 

The workspace manager (front panel) will be displayed on the screen 
specified by the screen parameter. 

■ The -multiscreen option causes vuewm to manage all the screens on the 
specified display. 

■ The -screens option specifies the screen names used to obtain screen-specific 
resources. 

For example, the resource: 

Vuesession*wmStartupcommand: \ 

vuewm -display local: 0.1 -multiscreen -screens zero one 

causes vuewm to manager all the screens on display 0. Screens and 1 are 
named zero and one. The workspace manager is displayed on screen 1 (named 
one). 

Worlcspaces in Multiple Screens 

When you manage multiple screens with vuewm, the workspace manager is 
displayed on only one screen. However, the other screens can have multiple 
workspaces. In order to switch workspaces on those screens, you must either 
add f .prev.workspace and f .next_workspace functions to the workspace 
menu, or create button or key bindings for them. 
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11 Clients That Help You Manage Windows 

Three additional clients are directly related to window management: 

■ resize 

■ xrefresh 

■ xwininf o 

Resetting Environment Variables with 'resize' 

The resize client resets three environment variables: TERM, LINES, and 
COLUMNS. This enables a shell to reflect the current size of its window. 
Resetting the environment variables enables non-client programs to adjust their 
output to the window's new size. Use resize whenever you resize a terminal 
emulator window and want a non- client program running in that window to 
reflect the window's new size. 

The resize client is typically used as an argument to the HP-UX eval 
command. 

For example, after you have resized a window, reset the LINES , and COLUMN 
environment variables to reflect the new window size by executing: 

eval 'resize' 

Repainting the Screen with 'refresh' 

The xrefresh client "repaints" the screen or a specified portion of the screen. 
This removes the "graphics litter" that occasionally disfigures a screen. 

The xrefresh client performs a similar task to the f . refresh window 
manager function. However, the xrefresh client, because of its options, is 
more versatile. 

For example, to repaint the upper left quarter of the screen, execute: 

xrefresh -geometry 800x400+1+1 
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Getting Window Information with 'xwininfo' ^^ 

The xwininf o client is a utility program that displays useful information about 
a window. The window is specified by selecting it (clicking mouse button 1) 
after executing the command to start xwininf o. 

For example, executing: 

xwininfo -stats 
displays this window information: 

xwininfo ==> Window id: OxSOOleO (has no name) 

==> Upper left X: 33 

==> Upper left Y: 13 

==> Width: 824 

==> Height: 846 

==> Depth: 8 

==> Border width: 

==> Window class: InputOutput 

==> Colormap: 0x80065 

==> Window Bit Gravity State: ForgetGravity 

==> Window Window Gravity State: NorthWestGravity 

==> Window Backing Store State: NotUseful 

==> Window Save Under State: no 

==> Window Map State: IsViewable 

==> Window Override Redirect State: no 

==> Corners: +33+13 -423+13 -423-165 +33-165 

-geometry =824x846+33+13 
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11 Using Other Window Managers 

The session manager resource wmStartupCommand allows you to use a different 
window manager during the session. For example, the entry: 

Vuesession*wmStartupcoinmand: twm 

causes the session manager to start the twm window manager rather than 
vuewm. 
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Filetypes and Actions 12 

The HP VUE File Manager can manipulate: 

■ Directories. These are standard directories and are represented by a folder 
icon. 

■ Files. These are standard files. However, HP VUE provides the ability to 
classify files into different types. Each file type can be assigned its own icon 
and behavior. 

■ Actions. Actions are unique to HP VUE. They allow operating system 
commands and applications to be represented, manipulated, and invoked 
graphically. 

File types and actions are defined by the HP VUE file management database. 
It provides the ability to: 

■ Define different file types and the recognition rules that let the system, 
distinguish one file type from another. For example, the system can define 
the file types MEMO and BM (bitmap), and be configured to recognize files 
with extensions .memo and .bm as files of those types. 

■ Associate icons with file types and actions for visual recognition. The 
icons are used by the file manager to provide a graphical representation for 
directory listings. 

■ Define actions that operate on files. For example, you can define an action 
entitled EDIT for editing operations. The behavior of an action can depend 
on the file type. For example, editing a MEMO file can invoke a text editor, 
while editing a BM file can invoke a bitmap editor. 

■ Associate icons with actions. For example, the EDIT action can be 
represented by an icon. The action can then be invoked by dragging a file 
icon onto the action icon or by selecting the action from the Actions menu. 
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Associate default actions with file types. The default action is the action 
that occurs when the user double-clicks a file in the file manager. 



12 Structure of the File Management Database 

This section covers: 

■ The naming convention for files in the file management database. 

■ The locations of database files, and the resources that control where the 
system looks for the files. 

■ How the database is created from system-wide, local, and user-specific 
portions. This allows you to add local and personal customizations to the 
database. 

Naming Conventions 

The file management database has two general parts: 

■ The file type database. This database consists of one or more files that 
describe the file types recognized by the system. Files in this database must 
follow the naming convention filename. ft. 

u The action definition database. This database consists of one or more files 
that define the actions the system recognizes. Files in this database must 
follow the naming convention filename . ad. 

Location of Database Files 

When an HP VUE session is started, the file management database is loaded 
by searching multiple directories for database files. There are several default 
directories; these defaults can be modified by adding, removing, or substituting 
directories. 

This section covers: 

■ The default search path for database files. 

■ How to modify the search path. 
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Default Directories 

By default, database files are located in three directories: 

■ $HOME/.vue/typGS. Files in this directory affect only the user. If you are an 
end user and intend to customize your database, you should do so only in 
this directory. 

■ /usr/local/lib/Xll/vue/types. Use this directory for database files that 
will be available to all users on the system. If this directory does not exist 
on your system, you can create it (this requires superuser permission). Once 
the directory is created, it will be searched the next time a user logs in. In 
general, this is the directory system administrators modify. 

■ /usr/lib/Xll/vue/types. This directory contains the default database files 
shipped with HP VUE. Its files create the system-wide file type and action 
definition databases. You should not modify the files in this directory. If you 
want to add or modify a file type or action, you should do so in one of the 
other database directories. 

Because the file management database is searched in the order listed 
above, personal customizations override system customizations, and system 
customizations override the default definitions. 

Caution The update process for HP VUE removes the current files in 

« /usr/lib/Xll/vue/types and replaces them with new ones. If 

you have modified those files and want to preserve the changes, 
move your modifications to /usr/local/lib/Xll/vue/types 
before updating. 
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The Default File Type and Action Definition Database 

The following figure shows the directory structure of the system- wide database 
shipped with HP VUE. 



/usr/ 1 ib/Xl 1 /vue/ types/- 



vue.ft 






vue. ad 


action copy 




<filenaine>.ad 
















action copy 



Figure 12-1. The System- Wide Default Database. 

Note these aspects of its organization: 

■ The file type definitions are contained in files with the naming convention 
filename, ft. 

■ Action definitions are contained in files with the naming convention 
filename . ad. 

■ The types directory contains a tools subdirectory. The tools directory 
and its subdirectories contain files representing actions defined in the 
action definition files. For example, /usr/lib/Xll/vue/types/vue.ad 
contains definitions for actions VI and RES.EDIT. The action files associated 
with these definitions are /usr/lib/Xll/vue/types/tools/edit/VI and 
/usr/lib/Xll/vue/types/tools/Xll_apps/RES_EDIT. These action files 
create the icons for the actions in the file manager applications directory. 
(See "Organization of the Applications Directory and Action Database" later 
in this chapter for more information.) 

Some actions do not have corresponding files in the tools directory, and 
therefore do not have action icons in the applications directory. For example, 
the EXIT_SESSION action defined in /usr/lib/Xll/vue/types/vue.ad is 
used by the workspace manager's logout button. This action does not appear 
in the applications directory. 
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Creating Local and Personal Databases 

To construct a local or personal database: 

1. Create one or more filename .ft or filename . ad files in the appropriate 
database directory (see "Default Directories," above). 

2. Edit these files to include the file types and actions you want: 

■ You can create an entirely new file type or action. 

■ You can modify an existing action by copying it from the system- wide 
database and modifying it. 

3. If you've added action definitions, you can create action files in the tools 
directory, or in a subdirectory you've created under tools. 

The following illustration shows the structure of a personal database created 
by user anna. It contains a file for file type definitions, two files for action 
definitions, and three subdirectories of tools containing the actions defined in 
the two action definition files. 
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/users/anna/ . vue/types/- 



- anna. ft 
-anna. ad 

-anna. editors . ad 
-tools/ 



■ edltina/ 1 



■editing/ 



•games/- 



EM&CSl 
EM&CS2 
WYSIWYG 



I DRAFT 

-printing/ FINAL 

I ( 



■COLOR 

-GOOD 

-BETTER 

-BEST 



Tools/ 
Subdirectories Action Copies 

Figure 12-2. A Personal File Type and Action Definition Database. 
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Adding Directories to tlie Database Search Path 

The resource Vue.TypesDirs identifies the directories containing database files. 
The value of the resource is a list of directories separated by commas. 

The syntax for specifying each directory is: 

[ hostname: ] [path/ ] directory^symbolic-name 

If the hostname is omitted, the system assumes that the directory is located on 
the local system. If you specify a relative path, it is assumed to be relative to 
the user's home directory. 

Clicking the applications directory button in the workspace manager displays 
a file manager view of the applications directory. Each top-level folder in this 
window corresponds to one of the directories in the Vue.TypesDirs search 
path. The folders are labeled with their symholic-name. If a directory on the 
search path does not exist, or does not have a tools subdirectory, it does not 
have a folder in the application directory window. 

The default value for the Vue.TypesDir resource is: 

Vue.TypesDirs: .vue/typesQpersonal-apps,\ 

/usr/local/lib/Xll/vue/types<81ocal-apps,\ 

/usr/lib/Xll/vue/typesQsystem-apps 

The directories are separated by commas; there can be no embedded spaces. 

There are two ways to change the database search path: 

■ For system- wide changes, edit the value of the Vue.TypesDir resource in 
/usr/lib/Xll/app-defaults/Vue. 

■ To make changes for a single user, load the new resource value into the 
resource database (using the RES -EDIT action or xrdb). The user must 
then log out and login in. (For more information on loading resources, see 
"Adding and Changing Resources with xrdb" in chapter 8. 
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General Syntax Rules for Database Files 

The following general syntax rules apply to both the file types and action 
definition databases: 

■ The database files are standard text files. 

■ There is one entry per line. Each entry consists of a number of fields. 12 

■ The backslash character (\) is used as an escape character, removing the 
special meaning of the character following it. When a backslash character is 
the last character on a line (a new-line character immediately follows the 
backslash; there can be no other characters between the backslash and the 
new-line character), the new-line character is not interpreted as the end of 
the entry. This allows you to put a single entry on more than one line. 

■ Fields are separated from one another by spaces or tabs. There can be no 
embedded spaces within a field, except for last field of each entry. 

■ Blank lines are ignored. 

■ If the first non-blank character in a line is the pound sign (#), the entire line 
is interpreted as a comment line. 

■ A commented line should never immediately follow a line ending with a 
backslash. 

■ You can use string variables in database files (see "Using String Variables in 
Database Files" later in this chapter). 



The File Types Database 

The file types database describes the file types known to the system and the 
criteria the system uses to differentiate one file type from another. 
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Default File Types 

The default file types are defined in /usr/lib/Xll/vue/types/vue.ft. 

Table 12-1. Default File Types 



File Type 


Naming Convention 


Description 


BM 


*.bm 


Bitmaps 


BROKEN_LINK 


— 


Broken link. This file was 
symbolically linked to a file that 
has been removed. 


DIRECTORY 


* 


Directories (folders). 


EXECUTABLE 


* 


Executable files. 


DATA 


* 


All files that are not directories or 
executables and do not match 
another file type. 


NODE 


* 


On Domain/OS systems only. A 
network node. 



Adding a File Type to the Database 

To add a new file type to a database: 

1. Choose which database file will contain the new file type. (See "Location of 
Database Files," above). The file name must end with .ft. 

2. If you are creating a database file in a directory other than one of the 
default directories, be sure to add its path to the list of directories specified 
by the Vue.TypesDirs resource. 

3. Add the file type to the selected file. The syntax of the file type database is 
described below. 

4. To activate the file type, reread the action definition database by double- 
clicking the REREAD _DB action icon in the system_apps/sys_admin 
applications directory. 
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File Type Fields 

Below is a portion of a typical file types database file. It defines file types for 
directories and executable files. 

DIRECTORY * d dir.l.bm dir.s.bm 

EXECUTABLE * !d&x exec.l.bm exec.s.bm EXECUTE 

DATA * !d!x data.l.bm data.s.bm EDIT, VIEW, PRINT 

Each definition is a separate line. (Use \ to indicate that the definition is 
continued on the next line.) A file type definition consists of six fields: 

Filetype Filename Mode Largelcon Smalllcon Actions 

Fields are separated from one another by spaces or tabs. The last field can be 
omitted. 

Filetype Field 

This is the name of the file type. File types should have unique names. 

Filename Field 

This field contains the naming convention for the file type. The following table 
describes the special characters in this field. 

Table 12-2. Special Characters in the Filename Field. 
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Character 



Meaning 



Matches any single character. 



Matches any sequence of characters (including a null string). 



Matches any of the characters (c) enclosed in brackets. 
Matches any of the characters in the range c through c. 



icc.l 



U-c1 



The pattern is compared to the full pathname of the file, including the host 
name {hostname: directory j filename). Thus, to specify a pattern that matches 
all files named xyz, you must specify a filename of */xyz. If you want to 
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include only files named xyz located on host hpcvxlp, you must specify a 
filename of hpcvxlp : */xyz. 

The database is searched in order, and the first match is used. Thus, if the 
filename patterns for two different file types overlap, you must specify the more 
specific one first. For example, three filetypes with filename patterns */ch??.c, 
* . c, and * must be specified in that order. 

Since personal database files in $HOME/.vue/types are searched before the 
system files in /usr/lib/Xll/vue/tjrpes, you must not specify general name 
patterns in $HOME/.vue/types that obscure other more specific entries in the 
system files. 

Here are some filename examples: 

File Name Entry Interpretation 

* . c All files ending with . c. 

chapter?. text 



chapter [1—9] .text 
hpcvxlp : /doc/sysadm/* .b 

♦/Mail/* 



All files named chapter a;, text, where x is any 
character. 

All files named chapter a;, text, where a; is a 
character in the range 1 through 9. 

All files ending in .b in the /doc/sysadm 
directory or any of its subdirectories on host 
hpcvxlp. 

All files in any Mail directories or their 
subdirectories. 



Mode Field 

The mode field contains a boolean expression specifying the mode requirements 
for the file. The expression is built from the following operators and values: 
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Table 12-3. Valid Operators and Values for the Mode Field. 



Character 


Meaning 


! 


Logical operator NOT. 


ft 


Logical operator AND. 


d 


The file is a directory. 


r 


The file is readable by the current user. 


w 


The file is writable by the current user. 


X 


The file is executable by the current user. 
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You can simulate a logical OR operator by creating several adjacent entries. 

Here are some mode examples: 

Mode Entry Interpretation 

! d Not a directory. 

! d& ! X Not a directory and not a file executable by the 



user. 



!d&r 



Not a directory, and readable by the user. 



Large and Small Icon Fields 

These two fields contain the location of the file containing the bitmap for this 
file type's large and small icons. The locations can be: 

■ The absolute pathname. 

■ A relative pathname. The system will use the bitmap search path specified 
by the environment variable XBMLANGPATH to look for the file. (Refer to the 
XmGetPixmap(3X) man page for additional information.) 

The large icon is used when the file manager view preference is set to "By 
Name and Icon." The small icon is used when the file manager view preference 
is set to "By Name and Small Icon." 
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Table 12-4. Size of Default HP VUE Large Icons. 



lile Type 


Width 


Height 


Data files 


22 pixels 


30 pixels 


Executable files 


32 pixels 


32 pixels 


Directories 


30 pixels 


23 pixels 



Table 12-5. Size of Default HP VUE Small Icons. 



FUe Type 


Width 


Height 


Data files 


14 pixels 


17 pixels 


Executable files 


16 pixels 


16 pixels 


Directories 


20 pixels 


16 pixels 



Actions Field 

This field contains a list of actions displayed in the file manager Actions menu 
when a file of this file type is selected. Items in the list are separated by 
commas. The first action in the list is the default action taken when the user 
double-clicks the file icon. 

Each action must have a corresponding entry in the action definition database. 

Example File Types 

Example file types are provided in 

/usr/lib/Xll/vue/examples/types/examples.ft. Seethe README 
file in the same directory for additional information. 
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Using String Variables in Database Files 

You can define a string variable in a database file that remains in effect for the 
rest of that file. The syntajc for defining a string variable is: 

set variable-name^ value 

Variable names can contain any alphanumeric characters and underscore (_). A 
new-line character must immediately follow value. 

To refer to the contents of a variable, use the syntax: 

$ [-C] ?;ana6/€_name[3-] 

For example, if a file type file contains: 

set TEXT. ACT=EDIT, PRINT 

BUDGET *.b !d budg.l.bm budg.s.bm ${TEXT.ACT}, GRAPH 

then the standard actions for file type BUDGET are EDIT, PRINT, and 
GRAPH. 



The Action Definitions Database 

There are several ways that the user may invoke an HP VUE action: 

■ By dragging a file icon onto an action icon. 

■ By double-clicking on a file icon. This initiates the default action for the file 
type. 

■ By dropping a file icon onto the workspace background. This also initiates 
the default action for the file type. 

■ By selecting a file icon, then selecting an action from the file manager 
Actions menu. 

■ By double- clicking the action icon. 

The action definitions database describes the actions known to the system, the 
operation done when the action is invoked, and the file type(s) for which the 
action is valid. 
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Organization of the Applications Directory and Action Database 

When the user clicks the applications directory control in the workspace 
manager, a file manager window opens with the current directory set to 
$HOME/.vue/apps. This directory acts as the top level directory for browsing 
all of the actions available to the user. The contents of $HOME/ .vue/apps is 
a set of symbolic links, one for each tools subdirectory along the user's file 
management database search path. 



Table 12-6. Symbolic Links for Application Directories. 



Symbolic 
Name 


Linked Action 
Database Directory 


Contents 


system-apps 


/usr/lib/Xll/vue/types/tools 


System-wide 
default actions. 


personal-apps 


$HOME/ . vue/types/tools 


Personal user 
actions. 


local-apps 


/usr/local/lib/Xll/vTie/types/tools 


Local actions. 



The name local-apps appears only when the directory 
/usr/local/lib/Xll/vue/types/tools exists. 
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/usr/lib/Xll/vue/types/tools/ 
7 $HOME/ .vue/ types/tools/ 
/usr/ local/ 1 ib/Xl 1 /vue/ types/tools/ 

Figure 12-3. 
The Applications Directory is Linked to the Action Definitions Database. 

The linkage provides user access to the actions in each database directory. 
Thus, for example, when the current file manager directory is personal-apps 
the user sees the actions contained in the directory $HOME/.vue/types/tools. 

The set of symbolic links in $HOME/.vue/apps are rebuilt by the file manager 
each time an HP VUE session is started. Therefore, changes to your 
Vue.TypesDirs resource appear in $HOME/ . vue/apps the next time you start 
an HP VUE session. For example, suppose the Vue.TypesDir resource is 
modified by adding an additional database directory, as follows: 

Vug . TypesDir : $HOME/ . vue/typesQpersonal-apps , \ 
/usr/local/lib/Xll/vue/typGsQlocal-apps,\ 
/usr/lib/Xll/vue/typesQsystem-appsA 
hpcvlpl:/usr/local/lib/Xll/vue/typesQremote-apps 

In this case, the symbolic name remote- apps appears in the 
applications directory the next time the user logs in; it will be linked to 
hpcvlpl : /usr/local/lib/Xll/vue/tjrpes/tools. 
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Providing a Graphical Representation of an Action 

An. action is defined by its entry in the action definition database. Once an 
action is defined, you can add it to the "Actions" menu for a specific file 
type, and you can create a control in the workspace manager that accesses 
that action. However, if you want the action to appear in the file manager 
12 applications directory window so that it can be manipulated graphically, 

you must place a copy of the action in a directory or subdirectory on the file 
management database search path. 

To make a copy of an action, you create an executable file with the same 
name as the action. The contents of the file doesn't matter (it can be zero 
length), but it must be executable. Action copies should be placed in the 
tools subdirectory, or a subdirectory beneath tools. The action copy is what 
users see when they press the applications directory control in the workspace 
manager and browse through the folders. They can invoke the action using this 
copy, or make additional personal copies of the action. 

The following illustration shows the relationship between the user's interaction 
with the applications directory and the underlying action definition database 
with its copies of actions. It shows a configuration with system- wide, local, and 
personal databases. Opening the directory personal-apps shows the contents 
of tools — in this case, three subdirectories. The print actions are accessed by 
opening printing, which contains three printing action copies. 
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Figure 12-4. The Applications Directory and Action Definition Database. 



Adding an Action Definition to the Database 

To add an action definition to the database: 

1. Choose which database file will contain the new action definition. (See 
"Location of Database Files," above.) The file name must follow the naming 
convention filename . ad. 

2. If you are creating a database file in a directory other than one of the 
default directories, be sure to add its path to the list of directories specified 
by the Vue.TypesDirs resource. New directories do not appear in the 
applications directory until the user logs out and logs back in. 

3. Add the action definition to the selected file. The syntax of the action 
definition database is described below. You can: 

■ Create an entirely new action. 

■ Copy an action from the system-wide action definition database and edit 
it. 
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4. Create a copy of the action in the same directory as the file containing the 
definition. This allows the user to access the action using the applications 
directory. Use the file manager File "New" function to create the file, or 
execute: 

touch action-name 

where action^name is the name specified in the Action Name field. This will 
create a new file with name action^name. 

5. Make the action file executable. You can use the file manager File 
"Properties" function, or execute: 

chmod 555 action^name 

6. Move the action file to the tools directory or one of its subdirectories. This 
allows you to access it from a folder beneath the applications directory. 

7. If you want to add the action to the Actions Menu for certain file types, add 
the action-name to the appropriate entries in the file types database. 

8. To activate the action definition, reread the action definition 
database by double- clicking the REREAD_DB action icon in the 
system_apps/sys_adinin applications directory. 

How the Action Database is Searclied 

Actions with the same name can exist in different directories. For 
example, you could copy the action VIEW from the system-wide directory 
/usr/lib/Xll/vue/types into a personal directory $HOME/ . vue/types and 
then modify it to execute a different command. When that action name is 
invoked from the file manager Actions menu, the database is searched for a 
match. 

Database directories are searched in the order specified by the Vue.TypesDirs 
resource. 
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/usr/ 1 ib/Xl 1 /vue/ types /<fi lenaine> . ad 



Figure 12-5. Default Search Scheme for the Action Definition Database. 

The order of action definition entries within a single database file is preserved. 
However, the order of searching multiple files within a single directory is 
arbitrary. 

Action Definition Fields 

Below is a portion of a typical action definition database. It defines two 
actions. 

BITMAP BM $"CACTION_L} ${ACTION_S> MAP BITMAP.DSIZE 
BITMAP.DSIZE \ 

* \ 

${ACTION.L> \ 

$-CACTI0N_S> \ 

COMMAND \ 

NO-STDIO \ 

•/.LocalHosty. \ 

/usr/bin/Xll/bitmap '/, (File) Arg_l "File To Edit:'"/, 

Each definition is on a separate line. (Use \ to indicate that the definition is 
continued on the next line.) Each action definition consists of 8 or 6 fields, 
depending on whether the action contains the command to be executed, or if is 
is mapped to another action: 

Command actions have the syntax: 
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Name FileType(s) Largelcon Smalllcon COMMAND WindowType Exec-host 
Exec-string 

Mapped actions have the syntax: 

Name FileType(s) Largelcon Smalllcon MAP AlternateAction 

Action Name 

This is the name of the action. 

File Type(s) 

This field consists of a list of file types for which the action is valid. Individual 
file types are separated by commas. If this field contains only the special 
character *, the action is valid for all file types. 

You can create an action that behaves differently for different file types by 
creating multiple action definitions, each of which specifies a different file type. 

Large and Small Icon Fields 

These fields contain the locations of the files containing the bitmaps for this 
action's large and small icons. 

The locations can be: 

■ The absolute pathname. 

■ A relative pathname. The system will use the bitmap search path specified 
by the XBMLANGPATH environment variable to look for the file. (For additional 
information, see the XmGetPixmap(3X) man page.) 

The large icon is used when the file manager view preference is set to "By 
Name and Icon." The small icon is used when the file manager view preference 
is set to "By Name and Small Icon." 
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Table 12-7. Size of Action icons. 



Icon Size 


Icon 
Dimensions 


Large 


32 X 32 


Small 


16 X 16 



12 



Action Type 

There are two action types. 



Table 12-8. Action Types. 



Type 


Description 


MAP 


MAP-type actions are not executed directly. Instead, they are 
mapped to another action specified in the Alternate Action field of 
the action definition. 


COMMAND 


COMMAND-type actions are commands to be executed. 



The contents of this field determines the requirements for the rest of the action 
definition. 

■ MAP types will have one more field — the Alternate Action Field. 

■ COMMAND types will have three more fields — Window Type, Exec-host, 
and Exec- string. 

You may notice other action types in the system action definition files. These 
are used to access internal capabilities of HP VUE. 

Alternate Action Field for MAP Action Types 

If the Action Type field is MAP, then the next field is the Alternate Action 
field. This field contains the name of another action to invoke. 

For example, if the actions definition database contains the following lines: 



EDIT * edit.l.bm edit.s.bm MAP 



VI 
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VI * vi.l.bm vi.s.bm COMMAND TERMINAL •/.DataHost*/. \ 
viX (File) Arg_l "Edit what file?"'/. 

the VI action is used when the EDIT action is invoked. 

12 Window Type 

The Window Type field is used with COMMAND action types. It specifies the 
windowing support required to execute this action. 

Table 12-9. Window Type Values for COMMAND Action Types. 



Value 


Defmition 


Typical Use 


NO-STDIO 


No windowing support is 
required. 


With X clients that handle their 
own user interface. 


TERMINAL 


The command must be executed 
in a terminal window. The 
window is closed when the 
command is exited. 


Full-screen commands (for 
example, vi). 


PERM- 
TERMINAL 


The command must be executed 
in a permanent terminal 
emulation window (the window is 
not closed when the command 
terminates). 


Commands that take some input, 
produce some output, then 
terminate. 


The following terminal types apply only to operating systems using hpterm as the 
default terminal emulator. 


OUTPUT- 
ONLY 


The command produces output 
that must be displayed, but 
requires no input. 


Commands that execute, produce 
output, and then terminate, such 
as Is and ps -el. 


SHARED- 
OUTPUT 


Similar to OUTPUT-ONLY, 
except only one window of this 
type is created per workspace. 
All SHARED-OUTPUT 
commands share this window. 


Commands producing a small 
amount of output. 
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Exec-host 

This field specifies the host where the command will be executed. 



Table 12-10. Valid Exec-Host Values. 



Value 


Description 


Typical Use 


hostname 


The named host. 


Environments in which the 
action should always be 
invoked on one particular host. 


•/.LocalHosty, 


The host where HP VUE is 
running. 


Environments where all 
processing should be done on 
one common host. 


•/.DataHost'/, 


The host containing the first 
file argument. 


Situations where you want to 
spread out the processing load, 
or where you anticipate 
problems with remote data 
access. 


'/.DatabaseHost'X 


The host where the action 
definition for this action was 
found. 


Where applications are 
installed on only one system in 
a network, and you cannot 
assume that the application 
performing the action resides 
on any other host other than 
the one that defined the action. 


*/," prompt"*/. 


Prompts the user for the host 
name each time the action is 
invoked. 


Environments where user needs 
control of the execution host. 
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Exec-strIng Field 

The exec-string field contains the command line for the command to be 
executed. 

For example, the following exec-string executes the client xclock. The 
command line requires no arguments, so the exec string is very simple: 

xclock 
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The command is executed directly, rather than being passed to a shell. 
Therefore, if a command requires shell capabilities, you must specify the shell 
in the execution string — for example: 

/bin/sh -c *ps | Ip' 

Action Arguments. Some actions must accept argum.ents that are supplied by 
*^ the user when the command is invoked. These arguments fall into two general 
categories: 

■ File or directory arguments. For example, when xrdb is used with the - 
edit option, it takes a file argument. The user can supply the argument by 
dragging a file icon to the action icon, or by selecting a file icon and choosing 
the action from the Actions menu. 

■ A non-file argument. An example of this is the bitmap client, which takes an 
argument that sets the size of the bitmap. 

The following table describes the syntax for including file and non-file 
arguments in exec strings. 
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Table 12-11. Syntax for the Execution String. 



Keyword 


Meaning 


•/.(File)Arg_n'/. 


Substitute the nth file argument. If the file name is in 
the form hostname: /path /filename, convert the name to 
the form /nis/ hostname/ path/ filename. 


y.Arg_ny. 


Substitute the nth file argument. Do not translate 
names from the form hostname : /path/ filename to the 
form /nis /hostname /path /filename form. 


*/,(File) kTg_n"prompt"X 


Substitute the nth file argument. If it is not found, 
prompt the user for a file name and substitute the 
response. If the file name is in the form 
hostname: /path/ filename, convert the name to the form 
/lifs/ hostname/ path/ filename. 


VXFile)" prompt"*/. 


Prompt the user for a file name and substitute the 
response. The user can enter file names in the form 
hostname :/ path/ filename. The file names will be 
translated into standard filenames. 


y.(File)Argsy. 


Substitute all of the remaining arguments. 


%"prompt"% 


Prompt the user and substitute the response. Do not 
use this syntax when prompting for a file name. 
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For example, the following exec-string provides the ability to execute xrdb 
-edit by dragging a data file to the action: 

xrdb -edit y.(File)Arg_iy. 
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With the next exec-string, the action can be started by dragging a file to the 
action icon or by double- clicking the action icon to display a prompt for the 
file. 

xrdb -edit y,(FilG)Arg_l"Enter file to cat:"*/. 

Since the file manager does not provide a graphical interface for non-file 
12 arguments (for example, you cannot drag a geometry argument to an action), 
you must use the *l"prompV% syntax to supply non-file arguments. 

For example, the following exec-string executes the bitmap client, which 
requires both a file name and a geometry option. 

bitmap 7, (File) Arg.l "Enter filename:"'/, \ 
•/."Enter geometry <width>x<height>:"y, 

The next exec-string prints a file with a banner containing the file name on an 
HP-TJX system: 

Ip -ty.Arg.iy. y.(File)Arg>iy. 

Note the different syntax for the two file arguments. The second 
argument (y,(File)Arg_iy.) converts an argument entered in the 
hostname : /path/ filename syntax to correct operating system syntax. For 
example, if the user enters hpcvaaa:/users/anna/myfile, the name is 
converted to /nf s/hpcvaaa/users/anna/myf ile. The first argument prints 
the unconverted name on the banner (hpcvaaa:/users/aima/myf ile). 

Specifying the Current Working Directory. When a command uses one or more 
file or directory arguments, the first argument determines the current working 
directory for the command: 

■ If the argument is a file name, the current working directory is set to the 
directory containing that file. 

■ If the argument is a directory name, the current working directory is set to 
that directory. 

Invoicing Actions with l\/luitiple Arguments. When an action accepts only one 
argument, but the user invokes it with more than one argument (for example, 
the user selects several files and drags them to the action icon), the action is 
executed repeatedly, once for each argument. 
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When an action specifies more than one argument, only that number of 
arguments is allowed. 

Executing Remote Files 

HP VUE can be configured to provide a great deal of network transparency. 

For example, a user can drag the icon for a text file located on remote host A 12 

to an action icon for an application located on host B, and see the output on 

the user's own local system. 

This section covers some aspects of remote execution. Chapter 4, "Distributed 
Operation," contains additional information. 

Enabling Remote Hosts 

Before the local system can run an application on a remote host, the remote 
host must be configured to allow use of its spc service. To do this, you must 
edit the file /usr/adm/inetd.sec on the remote host to include the local host. 
(See "Controlling Access and Security" in chapter 4.) 

Accessing Remote Files 

In order for HP VUE to provide the ability to execute an application on one 
host using data from a different host, NFS mounts must be established on the 
execution host to access the files on the data host. The mount point for the 
data host's file system must be /nfs/ hostname. 

Specifying the Remote Execution Host 

Actions can be invoked on a remote execution host if any of the following 
conditions are met: 

■ The action uses a hard-coded execution host that is different from the local 
host. 

■ The action specifies */,DataHosty, as the execution host and that the data host 
is a remote host. 

■ The action specifies '/.DatabaseHost'/, as the execution host and that the 
action is defined on a remote host. 
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■ The action contains a prompt-string for the execution host and the user 
supplies a remote hostname when prompted. 

Order of Entries in the Action Definition Database 

When an action is invoked with a file argument (by dragging a data icon to an 
action icon, or by selecting a file and then selecting an action from the Actions 
menu): 

1. The system uses the file type database to determine the file type of the 
argument. 

2. The system searches the action definition database for the first occurrence of 
the action that accepts that file type. 

Thus, entries in the action definition database should be ordered according to 
how selective they are about file types, with the most selective first. 

For example, consider the following entries in the Action Definition database 
(only the first two columns are shown): 

EDIT GRAPHICS . . . 
EDIT * 

This database defines an EDIT action that behaves differently for GRAPHICS 
files than for all other file types. 

If the entries were reversed, the first entry (EDIT *) would match all file types, 
and would be used for all files, including GRAPHICS files. 

Example Action Definitions 

Example action definitions are provided in 

/usr/lib/Xll/vue/examplGs/types/examples.ad. See the README 
file in the same directory for additional information. 
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An Action Definition Example 

There are often many different ways you can create an action database to solve 
a particular problem. The advantages and disadvantages of each approach may 
not be obvious. 

The examples in this section may help you choose the best technique for your ^^ 

application. They show several different ways to modify the action and filetype 
databases to support a new application. The (fictitious) application is a 
spreadsheet editor named spreadsheet. It runs in a terminal emulator window 
and is invoked with the command line: 

spreadsheet filename 

Example 1: A Simple File Type and Action Definition 

Before setting up the file management database for spreadsheet, you must 
decide on a naming convention for spreadsheet hies. A reasonable choice is 
filename. ss. To create the file type definition, add the following entry to a 
filename .ft configuration file: 

SS *.ss !d ss-data.l.bm ss-data.s.bm SPREADSHEET 

Next, create an action by adding the following entry to a filename . ad 
configuration file: 

SPREADSHEET SS ss-app.l.bm ss-app.s.bm COMMAND \ 
TERMINAL '/.LocalHosty, spreadsheet •/,(File)Arg.iy, 

These two entries create a database with the following properties: 

■ Any file named filename . ss is an SS file, and will be displayed using one of 
the "ss-data" icons. 

■ When an SS file is selected, the file manager Actions menu lists the single 
entry SPREADSHEET. 

■ If an SS file is double-clicked (or dragged onto the workspace window) the 
SPREADSHEET action is invoked with the SS file as an argument. 

■ If the SPREADSHEET action is invoked with no arguments (by 
double-clicking a SPREADSHEET icon), the spreadsheet command is 
executed with no arguments. This may or may not be a problem. 
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Example 2: An Action that Prompts for a File Argument 

To change the behavior of the SPREADSHEET action so that double-clicking 
it opens a dialog box asking for a filename, use the following action entry: 

SPREADSHEET SS ss-app.l.bm ss-app.s.bm COMMAND \ 

TERMINAL •/.LocalHost*/. spreadsheet y,(File)Arg_l"Filename:"y, 

Example 3: An Action With Less Stringent File Type Requirements 

In examples 1 and 2, the user cannot process a file with the SPREADSHEET 
action unless it follows the naming convention filename. ss. Attempting to 
drag a differently-named file onto a SPREADSHEET application icon displays 
a dialog box saying it could not find an appropriate action definition. 

To solve this problem, change the SPREADSHEET action so that it accepts 
any type of file: 

SPREADSHEET * ss-app.l.bm ss-app.s.bm COMMAND \ 

TERMINAL y,LocalHosty, spreadsheet y,(File)Arg_l"Filename:"y. 

Because the SS filetype still lists SPREADSHEET as the default action, 
double- clicking an SS file will invoke SPREADSHEET. However, a user can 
now invoke the SPREADSHEET action with file that doesn't conform to the 
SS naming convention by dragging the file onto a SPREADSHEET icon. 

Example 4: Configuring a Preexisting Action for a New File Type 

The previous examples create the SPREADSHEET action and defined it as the 
default action for a type of file (SS files). A different approach is to leave EDIT 
as the default action for SS files and redefine how EDIT behaves with an SS 
file. 

To do this, use the following file type definition in a filename .ft configuration 
file: 

SS *.ss !d ss-data.l.bm ss-data.s.bm EDIT 

Add the following entry to a filename . ad configuration file: 

EDIT SS ss-app.l.bm ss-app.s.bm COMMAND \ 

TERMINAL y.LocalHosty. spreadsheet y,(File)Arg_l"Filename:"y, 
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Make sure it is placed before a more general EDIT definition that would 
include SS files — for example, an action definition that begins with EDIT *. 

Note that this example has the same limitation as example 2 — there is no way 
to invoke the SPREADSHEET action on a non-SS file. 

Example 5: Mapping One Action to Another .|2 

The following action definitions use mapping to remove the major limitation 
of example 4. It allows any file type to be dragged to the SPREADSHEET 
action. Furthermore, it creates an "intelligent" EDIT action that invokes 
SPREADSHEET when an SS file is dragged to it. 

SPREADSHEET * ss-app.l.bm ss-app.s.bm COMMAND \ 

TERMINAL '/.LocalHostX spreadsheet '/.(File)Arg_l"Filename:"y. 

EDIT SS action. l.bm action. s.bm MAP SPREADSHEET 

Example 6: Providing a Second Action for a File Type 

With the above examples, dragging an SS file onto the printer control in the 
workspace manager invokes the standard PRINT action. This will probably not 
produce the desired output. Thus, you will probably want a special action that 
prints spreadsheet files. This example assumes that spreadsheet files can be 
printed with the command line: 

spreadsheet -print filename 
First, the SS entry in the filename .ft configuration file is changed to: 

SS *.ss !d ss-data.l.bm ss-data.s.bm EDIT, PRINT 

Then, the following entries are added to the filename . ad configuration file: 

PRINT-SS * act ion. l.bm act ion. s.bm COMMAND NO-SDTIO \ 
•/.LocalHost'/, spreadsheet -print y,(File)Arg_l"Filename:"y, 

PRINT SS action. l.bm action. s.bm MAP PRINT-SS 
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Customizing the Workspace IVIanager 

This chapter covers: 

■ Resources used to change the appearance and location of the workspace 
manager. 13 

■ Turning the workspace manager off and on. 

■ Rearranging the components in the panel. 

■ Changing the contents of the panel. 

■ Creating an entirely new workspace manager. 

The workspace manager is also referred to as the "front panel." That 
designation is used for its resource and configuration specifications. 
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Overview 

The workspace manager is a panel containing a variety of controls managed by 
the window manager. Control options provide a variety of ways to interact 
with the control: 

■ Read-only indicators. These show aspects of the system status — ^for example, 
the clock and date indicators. 

■ File indicators. These are read-only indicators that indicate when a 
designated file has changed — for example, the Mail control (Mail is also a 
toggle button.) 

■ Control buttons: 

n Push buttons. Push buttons cause the system to display a new window. 
When the user clicks on the button, it is visually depressed and 
immediately raised, ready to be pushed again. 

n Toggle buttons. In general, toggle buttons are used for processes that 
don't allow multiple occurrences. For example, the Mail toggle button 
cannot be used to display more than one Mail window. Clicking on the 
button when a Mail window is already open simply raises that window to 
the top of the window stack in the current workspace. 

n Drop zones. These are areas to which a user can drag a file icon in order 
to perform a task. An example of a drop zone is the trash can. 

■ Active client windows. For example, the load meter is an active xload client 
window. 

A workspace manager component can have more than one control option. For 
example, the Mail control is both a file indicator and a toggle button; its 
bitmap changes when the mailbox receives mail, and clicking on the control 
displays the mail window. 
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Workspace Manager Resources 

The window manager provides resources that let yon customize the appearance 
and behavior of the workspace manager. Like other resources, workspace 
manager resources can be specified by: 

■ Using xrdb to modify the user's resource database. 

■ Editing /usr/lib/Xll/app-def aults/Vuawm, for application-specific 
resources available more generally. 

Changes made to workspace manager resources take effect when the workspace 
manager is restarted. -13 

Syntax of Resources 

The general syntax for specifying resources for the workspace manager is: 

Vuewm*frontPanel [*row-name]*r€sonrce: value 

where row-name is name of the row as specified in the portion of the window 
manager resource file that configures the workspace manager. The default row 
names are Top and Bottom. 

Running HP VUE Without the Worl(space Manager 

The useFrontPamel resource determines whether or not a workspace manager 
is created. The resource is set to "True" in the file /usr/lib/Xll/app- 
def aults/ Vug wm. For example, the following line specifies that no workspace 
manager be displayed on any screen: 

Vuewm*useFront Panel: False 



Appearance Resources 

Appearance resources affect: 

■ The position of the panel. 

■ The spacing of the panel elements. 

■ The color and background pattern. 
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Position of the Panel 

The workspace manager has a geometry resource that specifies the initial 
placement of the workspace manager. It has the syntax: 

^:kx-offset ±y-offset 
The sign of the offset values determines how they are interpreted: 

Table 13-1. 
Using the Geometry Resource for the Workspace Manager. 



Offset 


Value 


Effect 


x-offset 


Positive 


Panel is left-justified against the specified offset. 


x-offset 


±0 


Panel is centered horizontally. 


x-offset 


Negative 


Panel is right-justified against the offset. 


y- offset 


Positive or +0 


Panel is placed that many pixels down from the 
top of the display. 


y- offset 


Negative or —0 


Panel is placed that many pixels up from the 
bottom of the display. 



For example, the following resource centers the workspace manager at the top 
of the display: 

Vuewm*f rontPanel*geometry : =+0+0 

The default is to center the workspace manager on the bottom of the display. 

The geometry resource does not affect the workspace manager size; the size 
is controlled by the geometries of the individual components and the spacing 
between components. 
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spacing Within the Panel 

The following resource take values in pixel units. The default is pixels. 

Table 13-2. Appearance of the Worlcspace Manager. 



Resource 


Description 


borderWidth 


The width of the border between the frame and controls. 


controlSpacing 


The width between controls. 


rowSpacing 


The distance between the top and bottom rows. 
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For example, the following line sets the border width to 7 pixels: 
Vuewm*f rontPanel*borderWidth : 7 

Worlcspace Manager Color 

The colorSetId resource specifies the palette color set used for the 
background and shadow colors of each row of the workspace manager. It takes 
as its value a color set number (1 through 8). 

The default color set depends on the display. 

Table 13-3. Workspace Manager Default Colors. 



Display Type 


Top Row Color Set 


Bottom Row Color Set 


High Color 


5 


3 


Medium Color 


4 


3 


Low Color 


1 


2 


Monochrome 


1 


2 
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For example, the following line causes the front panel to use color set 4 for 
both the top and bottom rows (named Top and Bottom). 

Vuewm*frontPanGl*Top*colorSetId: 4 

VuGwm*f rontPanel*Bottom*colorSetId : 4 

Workspace Manager Background Pixmaps 

The rowBackgroundPixmap resource specifies the pixmap used to tile the 
workspace manager background. For example, the following lines specifiy 
pixmaps used to tile both rows of the workspace manager. 

^2 Vuewm*frontPanel*Top*rowBackgroundPixmap: vertical.tile 

Vuewm*f rontPanel*Bottom*rowBackgroundPixmap : ribbing . 1 . bm 

I^ote that there are different ribbing bitmaps for medium and high resolution 
displays. 

The default workspace manager uses the 50_f oreground tile for the top row 
and ribbing for the bottom row. 



Specifying the Contents of the Workspace IVIanager 

This section describes: 

■ The location of files that specify the content and organization of the 
workspace manager. 

■ The general syntax for specifying the rows and contents of the panel. 

■ The syntax for specifying the appearance and behavior of the individual 
components. 

Window Manager Resource Files and Their Locations 

The contents of the workspace manager is specified in a window manager 
configuration file. 

Refer to the section "The Window Manager Configuration File" in chapter 11 
for a description the configuration file. 
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General Syntax for Specifying the Workspace Manager 

The contents and organization of the workspace manager is defined by an entry 
in the window manager resource file. The entry has the syntax: 

Front Panel panel-name 

Row [.row-name] 
i 

panel-control 

panel-control 
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Row irow-name] 

i 

panel-control 
panel-control 
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The panel is built from left to right, top to bottom. Each paneLcontrol entry 
creates a control of some sort in the workspace manager. The panel-control 
entries for each row are listed in the same order that they are displayed in 
the panel. A geometry option for each entry lets you set the size, but not its 
location, in the panel. Nested rows are not allowed. 
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FrontPanel <name> 
{ 



Row <row naine>- 



<pane l_cont ro 1 > 
<panel_control> 
etc. 



Row <row naine>- 

{ 

<pane l_c»nt ro 1 > 
<pane l_crant ro 1 > 
etc. 




Figure 13-1. The Workspace Manager is Built Row by Row. 

The default panel has two rows; however, you can add additional rows. 

Types of Workspace Manager Controls 

There are three basic categories of workspace manager controls: 

■ Predefined controls. These are controls created by window manager reserved 
words, and have predefined appearance and behavior. In certain cases, a 
predefined control can be modified (see "Predefined Controls" later in this 
chapter). 

■ Generic controls. The appearance and behavior of these controls are defined 
in the paneLcontrol entry for the controls. Generally, these controls invoke 
actions in the actions definition database. 

■ Clients. These are windows of active clients running in the workspace 
manager. 
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The Syntax of Components 

The entry for each item in the workspace manager consists of the control 
name followed by a number of optional fields that specify the appearance and 
behavior of the control. 

control-name [controLoption(s)] [bitmap(s)] [geometry] [function(s)] 
Each of these fields is described in detail below. 

Control Name Field 

Each control must have a unique name. Use the following guidelines for control .|3 
names: 

■ If the control is a toggle button that displays a pop-up window, the control 
name should be the same as the resource name of the window it creates 
(usually, the name of the client). This ensures that the window manager 
knows when the window is open. 

■ If the component is a predefined control, use the window manager reserved 
word. 

■ If the component is a client, you may want to use the client resource name. 
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Control Options Field 

The control-Options field specifies how the user interacts with the control. It is 
enclosed in square brackets and has the syntax: 



[i][f 



Individual entries in the control options field must be separated from one 
another by one or more spaces — for example, [TCI]. 

Table 13-4. Control Options. 





[N] 








rc] 




i 


T 


> 




* 


L 


► 




[Pj 








R, 





Control 
Option 


Description 


N 

T 
P 


Read-only indicator (the normal default). 
Toggle button. 
Push button. 


C 

L 
R 


Center the label or image (the default). 
Left-justify the label or image. 
Right-justify the label or image. 


I 


The control is a file indicator. The file that is 
monitored is specified by the 1 ileMame resource. (See 
"Adding a File Indicator Control" later in this 
chapter.) 


Z 


The control is a drop zone. 
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For non-predefined controls, any combinations are possible except: 

■ Multiple justifications. If more than one justification is specified, only the 
last is used. 

■ Client windows cannot be push buttons or toggle buttons. When a client 
is running in the front panel, it receives all the pointer and keyboard input 
when it has input focus. 

■ Client windows cannot have a bitmap specification. 

Some predefined controls allow you to specify control options in addition to the 
ones built into the definition. 

Bitmap Field 

The syntax for specifying a bitmap is: 

r 1 J absolute path 1 
^ -• \ relative path J 

If you use a relative pathname, the system will use the bitmap search path 
specified by the XBMLANGPATH environment variable to look for the file. (For 
additional information, see the XmGetPixmap(3X) man page.) 

The bitmaps for the default workspace manager are located in 
/usr/lib/Xll/bitmaps/Vuewm. 

Geometry Field 

The syntax for the geometry is: 

= width [xheight^ [+x-offset+y- offset] 

The offsets set the distance, in pixels, between the edge of the control and 
the control image (bitmap). If no offset is specified, the image fills the entire 
control. 
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width 




offset 



Figure 13-2. The Geometry off Workspace Manager Controls. 

13 If no geometry is specified, the default is to use the width and height of the 

control to the left of the one being specified. The default geometry for the first 
control in any row is dependent on the display resolution. 

Table 13-5. Deffault Control Geometries. 



Display Resolution 


Width 


Height 


Medium (1024x768) 


80 


80 


High (1280x1024) 


100 


100 



The vuewmbusy control takes two geometries. The first defines the size of the 
control; the second defines the size and position of the progress light within the 
control. 



Functions Field 

The Function field describes what happens when the user interacts with an a 
push button, toggle button, or drag and drop zone. The syntax of the Function 
field is: 






f .action action^name 
< f .exec "command" 

window-manager-function 

When the f .action form of the Function field is used, activating the control 
performs the specified action in the action definition database. (The large icon 
and small icon fields in the database are ignored.) 
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For example, the following entry in the workspace manager specification in 
sys.vuewmrc adds a drag and drop zone to the workspace manager. 

VI [Z] pencil. m.bm =90 f .action VI 

The action that takes place when a file is dropped on the control is specified in 
the action definition database: 

VI * vi.l.bm vi.s.bm COMMAND TERMINAL \ 

•/.DataHosty. vi'/, (File) Arg.l "Edit what file?"*/. 

Note that in order for actions to work properly with files on remote systems, 
NFS mounts must exist between the file systems on the two hosts. 

The action definition database is described in chapter 12. 

Specifying the Shell for 'f.exec' Commands. Commands executed with f . exec 
use the shell specified by: 

■ The MWMSHELL environment variable. 

■ The SHELL environment variable (if MWMSHELL doesn't exist). 

■ /bin/sh (if neither variable exists). 

Specifying l\1ultiple Functions. If a control is both a button (push button or 
toggle button) and a drop zone, the Function field for the button must be first. 
For example, the Trash control is specified by the line: 

Trash [P Z] Qtrash.l.bm f .action SHOW_TRASH f .action THROW. AWAY 

where SHOW_TRASH is the action for the push button and THROW_AWAY 
is the action for the drop zone. 
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Monitoring File Status with Panel Controls 

When a panel control is a file indicator (control option I), the file it monitors is 
specified by the f ileName resource, which has the syntax: 

Vuewm*coniroLname*f ileName : file-name 
For example, if the control panel contains: 

schedule [I P] (Dcalendar.bm Qexclaim.bm 

then the resource entry: 

Vuewm*schedule*f ileName : /users/yoder/schedules/projects . text 
causes the control to monitor the specified file. 
Monitored files must be local files or files to which NFS mounts exist. 

Drop Effects 

When a panel control is a drop zone, you can specify a series of bitmaps for 
the animated transition effect that is activated when a file is dropped on the 
control. Use the syntax: 

DropEffects control-name 

bitmap-file ttime-delay] 
bitmap-file [.time-delay] 
bitmap-file Itime-delay] 



where time-delay is the number of milliseconds. The default is 200 
milliseconds. When a time-delay is specified, it is used for the files beneath it 
in the list until another time-delay is specified. 
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Trash Can Files 

When a file is dropped on the trash control: 

■ The file is changed to a hidden file in its directory of origin and given an 
encoded name. 

■ Its original and encoded names are written to $HOME/.vuG/.trashinfo. 

When the user requests trash information by clicking on the trash control, the 
Trash Can window displays original names of the contents of .trashinf o. 



13 



Customizing the Worlcspace Manager 13-15 



Predefined Controls 

The following table describes the window manager reserved words that create 
predefined controls. 



Table 13-6. Predefined Controls. 
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Reserved 
Word 


Default 
Control Type 


Description 


vuevmblaink 


Read-only indicator 


Blank space. If the row has 
background ribbing, it will not show. 


vuewnrib 


Read-only 


Black space. If the row has 
background ribbing, it will show. 


vuewmbox 


Toggle button 


Specifies use of an icon box; reopens 
the icon box when it has been closed. 


vue\nnclock 


Read-only indicator 


Clock displaying the system time. 


vuevmdate 


Read-only indicator 


System date. 


vuevmname 


Toggle button 


Displays the dialog box for renaming 
workspaces. 


vuevmswtch 


Read-only indicator 


Contains buttons for switching 
workspaces. 


vuevznbusy 


Read-only indicator 


Provides a system "progress" light. 



The vuewmblack and vuewmrib controls can be used more than once. Only 
one of each of the other controls is allowed. For example, if yon try to include 
two vuewmclock controls, only the first will be inserted into the workspace 
manager; the other one will be ignored. 
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Augmenting the Behavior of Predefined Controls 

Predefined controls can be modified to some extent. For example, you can give 
vuemwclock push button behavior; that is, clicking on the clock will execute a 
certain action. 

The following table shows the allowable customization. 

■ The Control options column lists the options that can be specified. 

■ The Bitmap and Geometry columns indicate whether these fields are allowed. 

■ The Function column indicates whether the control can have a Functions 
field, and which of the three types (f . action, f . exec, and other window 
manager functions) are allowed. 

Table 13-7. Customizing Predefined Controls. 



Reserved 
Word 


Control 
options 


Bitmap 


Geometry 


Function 


vuevmblank 


Z P T 


no 


yes 


any 


vuewmrib 


I Z P T 


no 


yes 


any 


vueHmbox 


Z 


yes 


yes 


f. action 


vuewmclock 


Z P T 


no 


yes 


any 


vuewmdate 


Z P T 


no 


yes 


any 


vuemnname 


Z 


yes 


yes 


f. action 


vuewms witch 


none 


no 


yes 


none 


vuewmbusy 


I Z P T 


yes 


yes 


any 
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Modifying the Appearance of the Worlcspace Switch 

The following resources customize the appearance of the Workspace Switch. 

Table 13-8. Resources for the Worlcspace Switch Appearance. 



Resource 


Description 


vsButtonBorder 


The width in pixels of the border around the 
Workspace Switch. 


vsButtonShadovThicknes s 


The width in pixels of the top and bottom 
shadows of the buttons. 


vsButtonSpacing 


Horizontal spacing in pixels between the buttons. 


numberOfSwitchRows 


The number of rows of buttons. 



For example, the following line specifies that the buttons will be arranged in 
three rows: 

Vuewm^numberOf SwitchRows : 3 

The default switch background color is obtained from the color specification for 
the row of the workspace manager where it is located. The button colors are 
matched to the colors of the backdrops. 

Some additional resources for the workspace switch can be set using the 
component name Switch. For example, the following syntax defines a font for 
the workspace switch. 

Vuewm*Switch*f ontList : font 
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Configuring Wuewmbusy' 

To following resource configures the progress indicator as a blinking light: 

Vuewin4cuseBlinkingIndi cater: True 

When the resource is set to "False," the progress indicator is a bitmap design 
specified by the second bitmap in the control. 

The vuewmbusy control can take two geometries. The first defines the geometry 
of the control; the second specifies the size and offset of the progress light 
within the control. Thus, you can visually embed the progress light within 
some other control. In the default workspace manager, the vuewmbusy 
control consists of the progress light inside the push button for the action 
EXIT_SESSION (the logout button). 

Changing the Appearance of Wuewmdate' 

The format for the date displayed by vuewmdate can include multiple lines and 
multiple fonts. 

The syntax for vuewmdate resources is: 
Vuew*vuewmdate*re5owrce; value 

Table 13-9. vuewmdate Resources. 



Resource 


Description 


format 


The format string for the date. See the vuewm(lX) and 
strftime(3) man pages for more information. 


fontList 


The font used for the text. 


lontListn 


The font used for the nth line, where n is an integer one 
through 5. The default value is the value of the 
fontList resource. 
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Controls in the Default Workspace Manager 

The following two tables and accompanying illustration describe the controls in 
the default workspace manager. 



Table 13-10. Default Workspace Manager-'Top Row. 
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Name 


Type 


Optioii(s) 


Description 


vuevmclock 


Reserved 


Read-only 


Analog clock 


vuevmdate 


Reserved 


Read-only 


System date 


vaeload 


Client 


none 


Load meter, vueload displays the 
client window xload started with 
the resource name vueloaui (by the 
command line xload -name 
vueload). 


Mail 


Generic 


File indicator; 
toggle button; 
drop zone 


Mail box status; displays mailer 
window (default is elm) ; runs mailx 
with file argument. 


vuevmsvtch 


Reserved 


Read-only 


Controls for switching workspaces. 


Printer-Info 


Generic 


Drop zone; 
toggle button 


Starts a print process; displays the 
print status. 


Home 


Generic 


Push button 


Displays the file manager — home 
directory. 


Application 


Generic 


Push button 


Displays the file manager — 
applications directory. 


Trash 


Generic 


Drop zone; Push 
button 


Removes the file; displays the 
contents of the trash can. 
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Figure 13-3. Controls in the Default Workspace Manager. 
Table 13-11. Default Workspace Manager— Bottom Row. 



Logo 


Generic 


Push button 


Displays version of HP VUE. 


vuevmrib 


Reserved 


Read only 


Displays ribbing bitmap 


vuevmbox 


Reserved 


Push button 


Specifies use of an icon box; 
reopens the icon box when it has 
been closed. 


Terminal 


Generic 


Push button 


Displays a terminal emulator 
window (hpterm for HP-UX and 
OSF/1 systems, xterm for all 
others). 


vuestyle 


Generic 


Toggle button 


Displays the style manager. 


vuewmname 


Reserved 


Push button 


Displays the Rename Workspace 
dialog box. 


Lock 


Generic 


Push button 


Locks the session. 


Help 


Generic 


Push button 


Displays the help manager Help 
Index window. 


vuevmbusy 


Reserved 


Push button 


System progress light; exit session. 
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Customizing tlie Workspace Manager 

This section covers: 

■ Adding and removing components from the workspace manager. 

■ Creating a new workspace manager. 

■ Creating a vertical workspace manager. 

Changes to the workspace manager take effect when vuewm is restarted. 

Removing a Control from the Workspace Manager 

To remove a control, delete the line that creates that control. You may need 
to adjust the size of other elements to compensate for the item that has been 
removed. Note that each control is surrounded by bevels that create a 3-D 
effect. By default, the bevels are two pixels wide. 

Adding a Control to the Workspace Manager 

This section describes the steps for adding controls to the workspace manager. 
There are separate instructions for: 

■ Push button and toggle buttons. 

■ Client windows. 

■ File indicators. 

■ Drag and drop zones. 

If the addition is a read-only client window, the client must be started after 
vuewm has been restarted. 
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Adding Push Buttons and Toggle Buttons 

To add a push button or toggle button to the workspace manager: 

1. Select the way the user will Interact with the control — ^push button or toggle 
button. 

2. Create an image file for the entry. Typically, this is a bitmap displayed in 
the panel. 

3. Add the panel control to vuewmrc. If the control is a toggle button that 
displays a pop-up window, the control name must match the window 
resource name (usually, the name of the client). 

4. Create an action in the action definition database that describes the action 
to be taken when the user interacts with the control. (If the control is 

not connected to an action — ^for example, it executes an operating system 
command — this step is unnecessary.) 
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Adding a Client Window to the Woricspace i\/lanager 

To add a client window to the workspace manager: 

1. Add the panel control to vuewmrc. Do not include an image or label. 

2. Start the client from command line using the syntax: 

application-name —name control-name 

The command line must be executed after the window manager is running, and 
there should be no other clients running with the same name. 

For example, you could add the line: 

terminal 200x90 

to a the workspace manager specification in vuewmrc. Then, execute the 
following command in an existing terminal window to start the live terminal 
window in the workspace manager. 

xterm -name terminal -xrm 'terminal*primaryColorSetId: 5' 

The -xrm option is used to specify the resource primairyColorSetId for the 
window. This resource causes the window to be the same color as the other 
entries in the top row. 

To use the window, position the pointer within it to give it focus. 

You cannot configure a client window as a push button or toggle button; the 
client will receive all keyboard and pointer input. In addition, you cannot 
configure a client window as a drop zone. 
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Adding a File indicator Control 

File indicators can be used for local files and for nfs-monnted files. 
To add an file indicator control to the workspace manager: 

1. Create two image files for the entry. The control displays the second image 
when the monitored file is changed. It returns to the first image when one of 
the following happens: 

a. The user clicks the control. 

b. The monitored file shrinks. File size is monitored every 10 seconds. 

c. The window displayed by the control's action (if the control is a push 13 
button or toggle button) is closed. 

2. Add the panel control to vuewmrc. The controLoption field must include 
type I. If the control is simply a file indicator (it is not a push button, 
toggle button, etc.,), it does not have an action associated with it. 

3. Use the f ileName resource to specify the file to be monitored. It has the 
syntax: 

VuGwm* coniro/_name*f ileName : path/ filename 

The value must be the absolute path of the file. 

Adding a Drop Zone 

To add a drop zone to the workspace manager: 

1. Create an image file for the entry. This will be the bitmap displayed for the 
control in its rest state. 

2. Add the panel control to vuewmrc. 

3. If you want the control to provide a visual cue when it has been activated, 
create a series of transition bitmaps. Create a Drop Effects list for the 
effect in vuewmrc. (See "Drop Effects" earlier in this chapter.) 

4. Create an action in the action definition database that describes the action 
to be taken when the user interacts with the control. (The Functions field 
for a drop zone cannot use f . exec commands or other window manager 
functions.) 
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Creating a New Workspace Manager 

For certain systems, it may be more practical to create an entirely new 
workspace manager rather than edit the existing one. Similarly, it may be 
desirable to have several different workspace managers specified in vuewmrc, 
each with a different name. 

To create a new workspace manager: 

1. Use the syntax described in this chapter to specify its contents. Give the 
panel a unique front^paneLname. 

^2 2. Specify which workspace manager to use. This is done using the resource: 

Vuewm*f rent Panel *name : front^paneLname 



Creating a Vertical Workspace Manager 

To create a vertical workspace manager, design a panel that has many short 
rows. Specify both the width and height for the first control in each row; all 
the other controls in the row will be the same height. 

An example vertical workspace manager, and the resources to support it, are 
located in directory /usr/lib/Xll/vue/examples/Vuewm. 
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Changing Control Actions 

The push buttons and toggle buttons in the front panel use the action 
definition database to start processes. Changing the action taken when you 
operate these controls involves configuring the system so that a different action 
is invoked when the user clicks on the control. 

The three controls most commonly customized are: 

■ Mail, which, starts the MAIL action when clicked. 

■ Printer-Info, which starts the PRINT action when a file is dropped on it. 

■ Terminal, which starts the TERMINAL action. 

The MAIL, PRINT, and TERMINAL actions are defined in the file 
/usr/lib/Xll/vue/types/user-pref s . ad. 

Table 13-12. 



Action (in 
user-prefs.ad) 


Mapped to: 


Defined in: 


MAIL 


ELM 


/usr/lib/Xl 1/vue/types/vue . ad 


PRINT 


PRINT_PR 


/usr/lib/Xl 1/vue/types/pr int . ad 


TERMINAL 


TERM-LOCAL 


/usr/lib/Xl 1/vue/types/vue . ad 



There are two ways to change the action associated with the control: 

■ You can change the action invoked in the Functions field of the panel control. 
For example, you can change f . action PRINT to some other action. 

■ You can leave the front panel control unchanged, but map its action 
differently in the action definition database. For example, the PRINT action 
in /usr/lib/Xli/vue/types/user-pref s . ad can be remapped from 
PRINT.PR to some other action. 

Modifying the action definition database requires that you create a personal or 
local database. For example, the following procedure modifies the Mail control 
so that is runs the XYZ mailer, rather than the elm mailer. 
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Copy the action database file /usr/lib/Xll/vue/types/user-prefs.ad to 
$HOME/.vuG/types/my_prefs.ad . 

Change the mapping for the MAILER action by editing the line in 
my.prefs.ad: 

HAILER * ${ACTIOI_L} ${ACTIOI_S} MAP ELM 

to: 

MAILER * ${ACTIOI_L} ${ACTIOI_S> HAP XYZ 

Create an action definition for XYZ. You can create the definition in 
my_pref s . ad, or in some other filename . ad file in the same directory. 

need action 

Reread the action definition database by double- clicking the REREAD_DB 
action icon in the $HOME/.vuG/apps/systGm_apps/sys_admin directory. 

Restart the window manager. 



Example Workspace Managers 

The directory /usr/lib/Xll/vue/examplGs/Vuewm contains several example 
workspace managers and the resources needed to implement them. For 
additional information about the examples, read the README file in that 
directory. 
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Running Non-HP VUE Environments 

This chapter covers covers: 

■ How to run elements of HP VUE from a startup script (rather than from the 
system init process). 

■ How to stop HP VUE in order to run a non-HP VUE environment (such as 
XI 1 or Softbench). 



Running an HP VUE Session from a Startup Script 
Running the Session Manager from a Script 

Ordinarily, HP VUE is started during the system init process. When HP 
VUE is booted by the system init process, the system automatically runs the 
HP VUE Login Manager (vuelogin) and Session Manager (vuesession), as 
well as the Broadcast Message Server. 

This section explains how to run portions of the HP VUE session manager 
environment from a startup script, rather than from the init process. When 
HP VUE is started this way, the login manager is not run. 

There are several scenarios where this might be desirable: 

■ You may want most of the HP VUE environment, but do not want the save 
and restore capabilities of the session manager. 

■ You may want the user to log in at a system console and then run a script 
that starts the Broadcast Message server, the vuewm window manager, and 
various HP VUE clients. 
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Starting an HP VUE session from a startup script is accomplished using the 
vuesession client's norestore option. To run vuesession from a startup 
script, place the following line in the script file: 

/usr/lib/Xll/vue/etc/vuesession -norestore 

When vuesession is run with this option, it does not provide the ability to 
save and restore previous sessions. 

Use these guidelines when running vuesession from a startup script: 

■ Use the full path name in the command that starts vuesession. 

■ The only client that can be started before vuesession is xrdb. You must 
run xrdb before vuesession if vuesession requires resources from the 
database — for example, if you are using wmStartupCommand to start a 
different window manager. 

■ The vuesession client must be run in the foreground. 

■ You cannot run a window manager from the startup script, since vuesession 
starts the workspace manager. 

Caution if you run the session manager from a startup script, you must 

• make sure the script does not contain a line that starts the 

window manager. 
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When the session manager is started this way: 

■ It will run the vuewm workspace manager. To run a different window 
manager: 

□ Use the resource wmStartupCommand to specify a different window 
manager. 

D Use xrdb to read in this resource prior to running vuesession. 

■ It will run the Broadcast Message Server. You will be able to run HP VUE 
clients, and they will respond to color changes made in the style manager. 
However, fonts may not be properly set for the HP VUE clients. 

■ It does not run a vue. session file. Thus, the only clients that are started 
are the workspace manager and clients specified in the startup script. 

■ It will not load resources from vue. resources or sys. resources. Clients 
will get their resources from the file loaded with xrdb in the startup script, 

or from system app-def aults files. -14 

■ The user cannot log out from the front panel logout control. To stop the 
server and return to a system console, press (shift) [Ctrl! [Reset] ( (Shift) (Ctrl) 
( Pause ) for HP C1429A Enhanced Vectra keyboards). 

Running a Startup Script Using No-Windows Mode 

Note This section applies only to HP-UX operating systems. 
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The "No Windows" mode option in the login screen provides a system 
console from which you can run a startup script. In general, you use the same 
guidelines as desribed in the previous section. 

Keep in mind that when the startup script is run from "No Windows" mode, 
vuelogin is still running. Thus, after the user has pressed (shift) (Ctrl) (Reset) 
( (Shift) (Ctrl) (Pause) for HP C1429A Enhanced Vectra keyboards) to return to the 
system console, executing exit redisplays the login screen. 
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Running 'vuewm' Without l-IP VUE 

Normally, vuewm is configured to run in an environment running the HP VUE 
Broadcast Message Server. To run vuewm in an environment that is not using 
the BMS, set the following resource: 

Vuewiii*useMess aging: False 
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Moving From Softbench to HP VUE 



This chapter describes how configure your system to run HP VUE if you are 
already running Softbench. It also describes how to configure your system so 
that Softbench and HP VUE can coexist. 



Introduction 

HP VUE and Softbench are both built on the same Tool Integration Platform, 
which includes: 

■ The Broadcast Message Server (BMS). It routes message between processes. 
It can automatically invoke the receiver of a message if it is not yet running. 

■ Sub-Process Control Daemon (SPCD). It allows one process to invoke and 15 
control another process on a local or remote host. It also allows the parent 
process to communicate with the stdin, stdout, and stderr channels of the 
sub-process. 
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The Tool Integration Platform includes the following configuration files, located 
in directory /usr/softbench/conf ig. 

Table 15-1. Tool Integration Platform Configuration Files. 



File 


Contents 


softenv 


Environment variables settings for processes started through 
the SPCD. 


softinit 


Specifications used by the BMS for starting messaging tools. 


solttypes/C 


Filetype specifications used by the BMS with Softbench. VUE 
2.0 does not use this file. 
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Installing HP VUE and Softbench on the Same System 

When the BMS fileset is installed, any existing Tool Integration Platform 
configuration files are saved in the directory: 

/usr/softbench/oldconfig/ne/ea5e/usr/softbench/config 

where release for HP VUE 2.0 is vue2.0_A.00.00. 

If you have customized any of the configuration files, you may want to compare 
your old version of the file to the new one and make any desired modifications. 

Installing HP VUE and Softbench 1.1 

HP VUE 2.0 and Softbench 1.1 can be installed on the same system in either 
order without any problems. Their softinit files are combined. 
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Installing HP VUE and Softbench 1.0 

If HP VUE 2.01 and Softbench 1.0 are installed on the same system, the 
softinit file will only contain entries for the product last loaded. In order 
to create a softinit file containing entries for both products, execute the 
following command as super-user: 

cat /usr/softbench/config/softinitsrc/class-defaiilts/Tue. softinit \ 
/usr/sof tbench/oldconf ig/re/ea«e/usr/sof tbench/conf ig/sof t init \ 
> /nsr/softbencli/config/softinit 

(The command is broken up into multiple lines for readability. You can enter it 
as a single long line.) 

If you reinstall HP VUE 2.01 after executing this command, the merged 
softinit file is saved in /usr/sof tbench/oldconf ig, and you can merely 
restore it. If you reinstall Softbench 1.0 after having performed this step, you 
will need to rexecute the command to merge the files. 

Removing Softbench 1.0 

When HP VUE 2.01 and Softbench 1.0 are installed on the same system, 

the SBENCH fileset file lists the Tool Integration Platorm files. If you use 

the sysrm command to remove Softbench, you will also remove the Tool 15 

Integration Platform files required by HP VUE. To recover from this situation 

you must reinstall the BMS fileset from the HP VUE distribution. 
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Personal Customizations for Softbench 

The Installing HP Softbench manual explains how to customize Softbench 
by copying /usr/softbench/conf ig/softinit to $HOME/.softinit and 
modifying it. If you have created a $HOME/ .softinit file, you must modify 
this file using the following steps before running HP VUE. 

1. Rename $HOME/ . softinit file to some other name. 

2. Copy /usr/softbench/conf ig/softinit to $HOME/. softinit 

3. Add any modifications you had previously made to $HOME/. softinit to 
your new copy. 

Any time you modify your $HOME/. softinit file, you must restart both 
HP VUE and Softbench to make use of your modifications. The best way to 
accomplish this is to simply log out and restart your HP VUE session. 



Quitting Softbench 

When you are running HP VUE, you should stop Softbench applications by 
15 selecting individual applications from the Tool Manager window and using the 
Tool menu's "Stop" selection. 

Avoid using the Tool manager's "Quit" selection in its SoftBench menu. 
Clicking "Quit" displays a dialog box that allows you to quit Softbench, quit 
the Tool Manager, or cancel the operation. Selecting "SoftBench" kills all the 
BMS processes and all of the Softbench tools. When HP VUE detects that the 
BMS has unexpectedly died, it display a dialog box warning you that there are 
problems and you should save any work in process and log out. When the BMS 
dies, the logout button on the workspace manager becomes inoperative, and 
you must leave the session using [Shift) [CTRL] (Reset) ( [Shift) (CTRL) [ Pause ) for the 
HP C1429A Enhanced Vectra keyboard). When you exit a session this way, the 
session manager does not save the session. The next time you log in, the last 
saved session is run. 
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Additional Information 

Additional information about the compatibility of HP VUE and Softbench is 
contained in /etc/newconf ig/vue/doc/vne.softb.info. 
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Reference 

This section contains reference information about the HP VUE clients. The 
entries are arranged alphabeticaly, each starting with its own "page 1." 



HP VUE Man Pages 



Clients: hpterm (IX) 

vuecommand (IX) 
vuefile (IX) 
vuehello (IX) 
vuehelp (IX) 
vuelogin (IX) 
vuepad (IX) 
vuesession (IX) 
vuestyle (IX) 
vuewm (IX) 
xload (IX) 
xterm (IX) 

File Formats: vuewmrc (4X) 
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NAME 

hpterm - X window system Hewlett-Packard terminal emulator. 

SYNOPSIS 

hpterm [-toolkitoption] [-option] 

DESCRIPTION 

The hpterm program is a terminal emulator for the X Window system. It provides a TermO com- 
patible terminal for programs that can't use the window system directly. It also emulates many of 
the block mode features of HP terminals. Refer to the WARNINGS section below for additional 
information about running block mode applications. 

OPTIONS 

The hpterm terminal emulator accepts all of the standard X Toolkit command line options along 
with additional options all of which are listed below (if the option begins with a ' + ' instead of a '-', 
the option is restored to its default value): 

■b number 

This option specifies the size of the inner border (the distance between the outer edge of 
the character and the window border) in pixels. Associated resource: *borderWdth. 

-background color 

This option specifies the color to use for the background of the window. Associated 
resource: '"background. 

-bd color 

This option specifies the color to use for the border of the window. Associated resource: 
*borderColor. 

-bg color 

This option specifies the color to use for the background of the window. Associated 
resource: *background. 

-borderwidth number 

This option specifies the width in pixels of the border surrounding the window. Associ- 
ated resource: 'TopLevelShelLborder\^dth. 

-bs This option indicates that the "background" of the termO text entiy window should be the 

select color that corresponds to the specified background color. Associated resource: 
'"backgroundlsSelect. 

+bs This option indicates that the Tjackground" of the termO text entry window should be the 
specified background. Associated resource: ""backgroundlsSelect. 

-bw number 

This option specifies the width in pixels of the border surrounding the window. Associ- 
ated resource: ♦TopLevelSheILborder\^dtli. 

-cr color This option specifies the color to use for the text cursor. Associated resource: ♦cursor- 
Color. 

-display display 

This Qption specifies the X server to contact; see .^^(l). Associated resource: none. 

-e command {arguments ...] 

This option specifies the command (and its command line arguments) to be run in the 
hpterm window. The default is to start the user's shell. This must be the last option on 
the command line. Associated resource: none. 

-fbfont This option specifies a font to be used when displaying bold (alternate) text. This font 
must be the same height and width as the normal (primary) font. If only one of the nor- 
mal (primary) or bold (alternate) fonts is specified, it will be used for both fonts. Refer 
to the NLS section. Associated resource: *boldFont. 
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-^ color This option specifies the color to use for displaying text Associated resource: *fore- 
ground. 

•in font This option specifies a font to be used when displaying normal (primaiy) text If only 
one of the normal (primary) or bold (alternate) fonte is specified, it will be used for both 
fonts. Refer to the NLS section. Associated resource: *fbnt. 

-font/on^ 

This option specifies a font to be \ised when displaying normal (primaiy) text If only 
one of the normal (primaiy) or bold (alternate) fonts is specified, it will be used for both 
fonts. Associated resource: *font 

-foreground color 

This option specifies the color to use for displaying text. Associated resource: '"fore- 
ground. 

-geometry geometry 

This option specifies the preferred size and position of the hpterm window; see .^(1). 
Associated resource: I'termO^eometry. 

-help This option will display a help message. Associated resource: none. 

-i This option indicates that hpterm should supply the window manager with a bitmapped 

icon. Associated resource: bitmaplcon. 

+i This option indicates that the window manager should generate its own icon for hpterm. 

Associated resource: bitmaplcon. 

-iconic This option indicates that hpterm should be placed on the display in icon form. Associ- 
ated resource: *term0.iconic. 

•f iconic This option indicates that hpterm should not be placed on the display in icon form. 
Associated resource: *term0.iconic. 

-kshmode 

This option indicates that hpterm should convert characters entered with the extend key 
pressed into a two character sequence consisting of an ASCII escape followed by the un- 
extended character. Associated resource: *kshMode. 

-1 This option indicates that hpterm should send all terminal output to a log file as well as 

to the screen. Logging may not be enabled when the -L option is used. Associated 
resource: ^logging. 

+1 This option indicates that hpterm should not do logging. Associated resource: ^logging. 

-If ^fe This option specifies the name of the file to \diich the output log described above is writ- 
ten. \ifile begins with a pipe symbol (|), the rest of the string is assumed to be a com- 
mand to be used as the endpoint of a pipe. The default filename is HptermLog^LXXZY 
(where XXXXX is the process id of hpterm) and is created in the directory from which 
hpterm was started. Associated resource: *IogFile. 

-Is This option indicates that the shell that is started in the hpterm window should be a login 

shell (i.e. the first character of argv[0] will be a dash, indicating to the shell that it should 
read the user's /etc/profile and .profile (for ksh and sh) or /etc/csh.login and .login (for 
csh). Associated resource: *loginSheIl. 

+Is This option indicates that the shell that is started should not be a login shell (i.e. it will 
be a normal "subshell"). Associated resource: *IoginSheU. 

-map This option indicates that hpterm should map (de-iconify) itself upon pty output if it is 
unmapped (iconified). An initial period of time during which hpterm will not map itself 
upon pty output may be specified via the mapOnOutputDelay resource. Associated 
resource: *mapOnOutput. 

+map This option indicates that hpterm should not map (de-iconify) itself upon pty output if it 
is unmapped (iconified). Associated resource: *mapOnOutput. 

-mb This option indicates that the pointer cursor should be put into blanking mode. In this 
mode, the cursor will turn on when the pointer is moved, and will be blanked either after 
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a selectable number of seconds or after kejboard input has occurred. The delay is set 
via the pointerBlankDelay resource. Associated resource: *pointerBlank. 

+mb This option indicates that the pointer cursor should remain on. Associated resource: 
""pointerBlank. 

-mc mode 

This option determines how hpterm will generate the foreground color, shadow colors, 
and shadow tiles of the scrollbar and softkey widgets. Valid modes are "all", "shadow", 
and "none." Associated resource: *makeColors. 

-ms color 

This option specifies the color to be used for the pointer cursor. Associated resource: 
*pointerColor. 

-name name 

This option specifies the application name under which resources are to be obtained, 
rather than the default ej^cutable file name ("hpterm"). Associated resource: jiame. 

-reverse This option indicates that reverse video should be simulated by swapping the foreground 
and background colors. Associated resource: *reverseVideo. 

-rv This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. Associated resource: •reverseVideo. 

+rv This option indicates that reverse video should not be simulated. Associated resource: 
♦reverseVideo. 

-sb This option indicates that a scrollbar should be displayed. Associated resource: 

♦scroUBar. 

+sb This option indicates that a scrollbar should not be displayed. Associated resource: 
*scrollBar. 

-sbl^ color 

This option specifies the color to use for the background of the scrollbar window. Asso- 
ciated resource: *scrollBar.backgrouiid. 

-sb^ color 

This option specifies the color to use for the foreground of the scrollbar window. This 
value will be ignored if the makeColors resource is set to all. Associated resource: 
"'scrollBar.foreground. 

-sld)g color 

This option specifies the color to use for the background of the softkey window. Associ- 
ated resource: *softk^.background. 

-sk^ color 

This option specifies the color to use for displaying softkey text. This value will be 
ignored if the makeColors resource is set to all. Associated resource: 
'"softkey.foreground. 

-s}sinfont 

This option specifies a font to be used when displaying softkey text. Associated resource: 
*softkey.font. 

-si number[sujfix] 

liiis option indicates the number of off screen lines to be saved in the terminal buffer. If 
no suffix is included or the suffix is 1, the total length of the terminal buffer will be 
number plus the length of the terminal window. If the suffix is s the total length of the 
terminal buffer will be (number plus one) times the length of the terminal window. 
Associated resource: *saveLines. 

-ti name This option specifies a name for hpterm to use i^en identifying itself to application pro- 
grams. Refer to the WARNINGS section for additional information about using hpterm 
with block mode applications. Associated resource: *termld. 
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•title name 

This option specifies a window title for hpterm. This string may be used by the window 
manager when displaying the application. Associated resource: .TopLevelShelLtitle. 

•tm string 

This option specifies a string containing terminal-setting keywords and the characters to 
which they may be bound. Associated resource: *ttyModes. 

■tnname 

This option specifies a name for hpterm to set the $TERM environment variable to. 
Associated resource: *termName. 

-vb This option indicates that a visual bell is preferred over an audible one. Instead of ring- 

ing the terminal bell ^enever a Control-G is received, the window will be flashed. 
Associated resource: *visualBeU. 

+vb This option indicates that a visual bell should not be used. Associated resource: *visual- 
BeU. 

-xrm resourcestring 

This option specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. Associated resource: none. 

-C This option indicates that the window should receive console output. The server must be 

authorized to receive console output. See "XConsoles" below for additional informa- 
tion. Associated resource: none. 

•Seen This option specifies the last two letters of the name of a pseudoterminal to use in slave 
mode, and the file descriptor of the pseudoterminal's master. This allows hpterm to be 
used as an input and output channel for an existing program and is sometimes used in 
specialized applications such as pam(V). This option will only work with pty names of 
the form "ttyxx." For example, "-S pOl" specifies "ttypO" on file descriptor 1. Associ- 
ated resource: none. 

Spty.fd This option specifies the unique portion of the name of a pseudoterminal to use in slave 
mode, and the file descriptor of the pseudoterminal's master. This allows hpterm to be 
used as an input and output channel for an existing program and is sometimes used in 
specialized applications such as pam(l). This option will work for all pty names. For 
example, "-S pO.l" specifies "ttypO" on file descriptor 1 and "-S p02.13" specifies 
"ttyp02" on file descriptor 13. Associated resource: none. 

-U Reserved for internal use. 

-W Reserved for internal use. 

The following command line arguments are provided for compatibility with 

older versions. They may not be supported in future releases as the X Toolkit provides 

standard options that accomplish the same task. 

^geometry 

This option specifies the preferred position of the icon window. It is shorthand for 
specifying the ""iconGeometry resource. Associated resource: .iconGeometry. 

•H string This option specifies the title for hpterm^s window. It is equivalent to -title string. Asso- 
ciated resource: .TopLevelShelLtitle. 

-n string This option specifies the icon name for hpterm's windows. It is shorthand for specifying 
the ♦iconName resource. Associated resource: *iconName. 

-r This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. It is equivalent to -reversevideo or -rv. Associated resource: 
♦reverseVideo. 

+r This option indicates that reverse video should not be simulated. It is equivalent to +rv. 

Associated resource: ♦reverseVideo. 

■w number 

This option specifies the width in pixels of the border surrounding the window. It is 
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equivalent to 4)orderwidth number or 4w number. Associated resource: 
«TopLevelShell.borderWidth. 

RESOURCES 

The hpterm window consists of a Motif shell widget which contains a form widget. The form 
widget contains a termO widget, scrollbar widget, and softkey widget. Resources specific to the 
shell widget are: 



Name 



hpterm Resource Set 



Class 



Type Default 



borderColor BorderColor Pixel black 

borderWidth BorderWidth int 2 

geometry Geometry string 

iconGeometry IconGeometry string 

name Name string hpterm 



title 



Title 



string Terminal emulator 



borderColor 

This resource defines the border color of the hpterm window. 

borderVTidth 

This resource specifies the width of the hpterm window border. This value may be 
modified by the window manager. 

geometry 

This resource specifies the preferred size and position of the hpterm window. 

iconGeometry 

This resource specifies the preferred size and position oi hpterm when iconified. It is not 
necessarily obeyed by all window managers. 

name This resource specifies the name of the instance of the program. It is used when extract- 
ing resources from the resource database. 

title This resource specifies the window title for hpterm. This string may be used by the win- 
dow manager when displaying this application. 
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termO Resource Set 




Name 


Class 


T^pe 


Defoult 


allowSendEvents 


AllowSendEvents 


Boolean 


FALSE 


background 


Background 


Pixel 


"white" 


backgroundlsSelect 


BackgroundlsSelect 


string 


FALSE 


bitmap 


Bitmap 


string 




bitmaplcon 


Bitmaplcon 


Boolean 


FALSE 


boldFont 


Font 


string 


see NLS below 


copyLine 


CopyLine 


string 


"right" 


cursorColor 


Foreground 


Pixel 


"black" 


cut 


Cut 


string 


"left" 


flashBorder 


FlashBorder 


Boolean 


FALSE 


font 


Font 


string 


see NLS below 


foreground 


Foreground 


Pixel 


"black" 


&tAttribute 


SoftkeyAttribute 


int 


2 


&iLabel 


SoftkeyLabel 


string 


see below 


&»String 


SoftkeyString 


string 


see below 


halfBrightlnhibit 


HalfBrightlnhibit 


Boolean 


FALSE 


iconic 


Iconic 


Boolean 


FALSE 


intemalBorder 


BorderWidth 


int 


2 


ke)/boardLanguage 


KeyboardLanguage 


string 


see NLS below 


keyboardLanguageList 


KeyboardLanguageList 


string 


see NLS below 


kshMode 


KshMode 


Boolean 


FALSE 


logFile 


LogFile 


string 


"HptermLogXZXXX" 


logging 


Logging 


Boolean 


FALSE 


loginShell 


LoginShell 


Boolean 


FALSE 


makeColors 


MakeColors 


string 


"none" 


mapOnOutput 


AutoMap 


Boolean 


FALSE 


mapOnOulputDelay 


MapDelay 


int 





paste 


Paste 


string 


"middle" 


pointerBlank 


PointerBlank 


Boolean 


FALSE 


pointerBlankE>elay 


PointerBlankDelay 


int 


3 


pointerColor 


Foreground 


Pixel 


"black" 


pointerShape 


PointerShape 


string 


"xterm" 


reverseVideo 


ReverseVideo 


Boolean 


FALSE 


romanS 


Romans 


Boolean 


TRUE 


saveLines 


SaveLines 


string 


"Is" 


scroIlBar 


ScroIlBar 


Boolean 


FALSE 


softkeyInitializel6 


Softkeylnitializeie 


Boolean 


FALSE 


softkeySelect 


SoftkeySelect 


string 


"left" 


stickyNextCursor 


StickyCursor 


Boolean 


TRUE 


stickyPrevCursor 


SticlqCursor 


Boolean 


TRUE 


termid 


Terrald 


string 


"X-hpterm" 


temiName 


TermName 


string 


"hpterm" 


ttyModes 


TtyModes 


string 


none 


visualBell 


VisualBell 


Boolean 


FALSE 



allowSendEvents 

This resource defines whether synthetic key and button events (generated using the X 
protocol SendEvent request) should be interpreted or discarded. 

background 

This resource defines the background color of the text window. 

backgroundlsSelect 

This resource controls the color used as the "background" of the termO text entry window 
and defaults to False. When False, the background is the color specified. When True, the 
background is the "select color" that corresponds to the background. For visual 
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consistency with other Motif-based applications, set this resource to True. 

bitmap This resource defines whether hpterm will override its built in bitmap icon with a user 
specified bitmap icon. If the path does not begin with a "/" or "./", it will be processed 
relative to "/usr/lib/Xll/bitmaps". 

bitmaplcon 

This resource defines whether hpterm will supply the window manager with a bitmapped 
icon. The supplied bitmap may be ignored by the window manager. 

boldFont 

This resource defines the font used for bold (alternate) text. See "NLS" below for 
defaults. 

copyLine 

This resource defines the pointer button/modifier combination to be used to activate the 
CopyLine function. See "POINTER USAGE" below. 

cursorColor 

This resource defines the text cursor color. The pointer cursor color is defined by the 
pointerCoIor resource. 

cut This resource defines the pointer button/modifier combination to be used to activate the 
Cut function. See "POINTER USAGE" below. 

flashBorder 

This resource defines whether hpterm window border will change color when the pointer 
cursor enters or leaves the window. 

font This resource defines the font used for normal (primary) text. See the 
'^trmOfontLanguage (class TermO.FontLanguage) Resource Set" table and "NLS" below 
for defaults. 

foreground 

This resource defines the foreground (text) color of the text window. 

&tAttribute 

This resource defines the softkey attribute for softkey « (1 - 16). If "softkeyInitializel6" is 
true, all 16 softkey attributes can be initialized. If it false, only the first 8 softkey attributes 
can be initialized. 

&t Label 

This resource deflnes the softkey label for softkey « (1 - 16). If "softkeyInitializel6" is 
true, all 16 softkey labels can be initialized. If it false, only the first 8 softkey labels can be 
initialized. The default labels for softkeys 1 - 8 are "fl" - "f8." The default labels for soft- 
keys 9 - 16 are empty. 

£vString 

This resource defines the softkey string for softkey « (1 - 16). If "softkeyInitializel6" is 
true, all 16 softkey strings can be initialized. If it false, only the first 8 softkey strings can 
be initialized. The default strings for softkeys 1 - 8 are "<esc>p" - "<esc>w." The 
default labels for softkeys 9-16 are empty. 

halffirightlnhibit 

This resource defines whether half-bright enhancements will be not be generated. When 
true, full-bright characters will be used instead of half-bright characters. 

iconic This resource defines whether hpterm will start up in iconic form. 

intemalBorder 

This resource defines the number of pixels between the characters and the window 
border. 

keyboardLanguage 

This resource defines the default keyboard language hpterm should use. See "NLS" 
below for details and defaults. 
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keyboardLanguageList 

This resource defines the list of keyboard languages that may be selected from the termi- 
nal configuration menu. See "NLS" below for detail and defaults. 

kshMode 

This resource defines whether hpterm will operate in ksh mode. In ksh mode, hpterm 
converts characters entered with the extend key pressed into a two-character sequence 
consisting of an ASCII escape followed by the un-extended character. 

logFile This resource defines the name of the file to ^ich a terminal session is logged. The 
default is "li^tvnoLogXXXXX" (wheteXXXXXis the process id of hpterm). 

logging This resource defines whether a terminal session will be logged. It is also available at 
runtime via the Device Control menu. Logging may not be enabled ^en the "-L" option 
is used. 

loginShell 

This resource defines \v4iether the shell to be run in the window will be started as a login 
shell (i.e., the first character of argv[0] will be a dash, indicating to the shell that it should 
read the user's /etc/profile and .profile (for ksh and sh) or /etc/csh.login and .login (for 
csh). 

makeColors 

This resource is provided for backward compatibility with older versions of hpterm; since 
it may not be supported in future releases, it is no longer recommended for use. This 
resource defines how the bottomShadowColor, foreground, and topShadowColor 
resources of the scrollbar and softkey widgets will be generated and how the foreground 
resource of the termO widget will be generated. If the value of this resource is "all", then 
hpterm will use the value of the background resource of the termO widget to generate a 
value for the foreground, and the background resource of the softkey and scrollbar widg- 
ets to generate values for the bottomShadowColor, foreground, and topShadowColor 
resources such that there is a 3-D look. In this case the topShadoWTile and bottomSha- 
doWTile are always set to "foreground." If the makeColors resource value is "shadow" 
the bottomShadmvColor and topShadowColor will be generated but for^round will not 
be generated. If the makeColors resource value is set to "none" then no colors will be 
generated. 

mapOnOutput 

This resource defines whether hpterm will map (de-iconify) itself upon pty output if it is 
unmapped (iconified). An initial period of time during which hpterm will not map itself 
upon pty output may be specified to allow hpterm to not map itself upon initial shell out- 
put. The delay is set via the mapOnOutputDelay resource. 

mapOnOutputDelay 

This resource defines the number of seconds at startup during which hpterm will not map 
(de-iconify) itself upon pty output. 

paste This resource defines the pointer button/modifier combination to be used to activate the 
Paste function. See "POINTER USAGE" below. 

pointerBlank 

This resource defines whether hpterm will put the pointer cursor into blanking mode. In 
blanking mode, the pointer cursor will turn on when the pointer is moved, and will be 
blanked either after a selectable number of seconds or after keyboard input has occurred. 
The delay is set via the pointerBlankDelay resource. 

pointerBlankDelay 

This resource defines the number of seconds to wait before blanking the pointer cursor 
after the pointer has been moved. When set to "0", the pointer will be blanked only upon 
keyboard input. 

pointerColor 

This resource defines the pointer cursor color. The text cursor color is defined by the 
cursorColor resource. 
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pointerShape 

This resource defines the pointer cursor shape. Valid cursor shapes may be found in the 
file "/usr/include/Xll/cursorfonth." Shapes are specified as the name with the leading 
"XC_" dropped. Valid cursor shapes include "leftjptr", "crosshair", and "xterm." 

reverseVideo 

This resource defines whether reverse video will be simulated by swapping the fore- 
ground and background colors. 

romanS 

This resource controls the mapping of keys to characters and is effective only for western 
european keyboards. RomanS encoding is \ised when set to TRUE, ISO 88S9-1 encoding 
is used when set to FALSE. (It is the user's responsibility to ensure that correctly 
encoded fonts are used; refer to the discussion on fonts in your Using the X Window Sys- 
ton Manual for more information on font characteristics.) 

saveLines 

This resource defines the number of lines in the terminal buffer beyond the length of the 
window. The resource value consists of a "numbei" followed by an optional "suffix." If 
no suffix is included or the suffix is "1" the total length of the terminal buffer will be 
number plus the length of the terminal window. If the suffix is "s" the total length of the 
terminal buffer will be (number plus one) times the length of the terminal window. 
Hpterm will try to maintain the same buffer to window ratio when the window is resized 
lai^r. 

scrollBar 

This resource defines whether the scrollbar will be displayed. 

softkeyInitiaIizel6 

This resource enables initialization of all 16 softkeys. If false, only the first 8 softkeys can 
be initialized via resources. 

softkeySelect 

This resource defines the pointer button/modifier combination to be used for selecting 
softkeys. See "POINTER USAGE" below. 

sticlgrNextCursor 

This resource defines whether the cursor should be homed when the Next key is pressed. 
When true, the cursor will be in the same screen position after the key is pressed that it 
was in before pressing the key. When false, the cursor will be moved to the upper left 
hand comer of the screen after the key is pressed. 

sticI^PrevCursor 

This resource defines whether the cursor should be homed when the Prev key is pressed. 
When true, the cursor will be in the same screen position after the key is pressed that it 
was in before pressing the key. When false, the cursor will be moved to the upper left 
hand comer of the screen after the key is pressed. 

termid This resource defines the name for hpterm to use when identifying itself to application 
programs. Refer to the WARNINGS section for additional information about using 
hpterm with block mode applications. 

temiName 

This resource defines the string for set the "$TERM" environment variable. 

ttyModes 

This resource specifies a string containing terminal-setting keywords and the characters to 
which they may be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, 
swtch, start, stop, brk, susp, dsusp, rpmt, flush, weras, and Inext. Control characters may 
be specified as '^char (e.g. '^c or ^u), and '^? may be used to indicate delete. This is very 
useful for overriding the default terminal settings without having to do an stty every time 
an hpterm is started. 

visualBell 

This resource defines whether a visible bell (i.e. flashing) should be used instead of an 
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audible bell when Control-G is received. 



termO^ontLanguage (class TemiO.FontLaiiguage) Resource Set 



Name 



Class 



Type Default 



primaiy.high 

primaiy.medium 

primary.low 

alternate.high 

altemate.medium 

altemate.low 



FontPosition.Size 
FontPosition.Size 
FontPosition.Size 
FontPosition.Size 
FontPosition.Size 
FontPosition.Size 



stnng 
string 
string 
string 
string 



see NLS below 
see NLS below 
see NLS below 
see NLS below 
see NLS below 



string see NLS below 



fontLanguage.primary.}ugfi 

This resource defines the default normal (primary) font for displays with high resolution 
monitors. See "NLS" below for additional information. 

^njLan^a^.primaiy.medium 

This resource defines the default normal (primary) font for displays with medium resolu- 
tion monitors. See "NLS" below for additional information. 

fontLang^age.pTimary.low 

This resource defines the default normal (primary) font for displays with low resolution 
monitors. See "NLS" below for additional information. 

fontLanfftageMlteraateMgfi 

This resource defines the default bold (alternate) font for displays with high resolution 
monitors. See "NLS" below for additional information. 

fontLanguage^ltemateMitdium 

This resource defines the default bold (alternate) font for displays with medium resolu- 
tion monitors. See "NLS" below for additional information. 

/(7n2:La/i^a^e^ltemate.low 

This resource defines the default bold (alternate) font for displays with low resolution 
monitors. See "NLS" below for additional information. 

The following resources are specified as part of the "softkey" widget (name "softkey", class "Soft- 
key"). For example, the softkey font resource would be specified one of: 

HPterm*softkey*font: hp8.8xl6 
HPterm*Softkey*font: hp8.8xl6 
*Softicey*Font: hp8.8xl6 

Additional resources and information can be found in the XinPrimitive(3X) and CORE(3X) man 
pages along with additional information about the various shadow options. 



Name 



Class 



Softkey Resource Set 



Type Default 



background 


Background 


Pijffil 


'Vhite" 


bottomShadowColor 


Foreground 


Pixel 


"black" (see below) 


bottomShadowTile 


BottomShadowTile 


string 


"foreground" (see below) 


font 


Font 


string 


(see below) 


foreground 


Foreground 


Pixel 


"black" (see below) 


topShadowColor 


Background 


Pixel 


'Vhite" (see below) 


topShadowTile 


TopShadowTile 


string 


"SOforeground" (see below) 
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background 

This resource defines the background color of the softkey window. 

bottomShadowCoIor 

This resource defines the color that is combined with the bottom shadow tile and fore- 
ground color to create a pixmap used to draw the bottom and right sides of the softkey 
borders. This maybe overridden by the termO makeColors resource described above. 

bottomShadowTUe 

This resource defines the tile used in creating the pixmap used for drawing the bottom 
and right shadows for the softkey borders. Valid tile names are described in 
XmCreateTile(3X). This maybe overridden by the termO makeColors resource described 
above. 

font This resource defines the font used for softkey text The softkey font will default to the 
normal (primary) font of the text window. 

for^tround 

This resource defines the foreground (text) color of the softkey window. This may be 
overridden by the termO makeColors resource described above. 

topShadowCoIor 

This resource defines the color that is combined with the top shadow tile and foreground 
color to create a pixmap used to draw the top and left sides of the softkey borders. This 
maybe overridden by the termO makeColors resource described above. 

topShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the top and 
left shadows for the softkey borders. Valid tile names are described in 
XmCreateTile(3X). This maybe overridden by the termO makeColors resource described 
above. 

The following resources are specified as part of the "Xmscrollbar" widget (name "scrollBar", 
class "ScrollBar"). Some example scrollbar resources are: 

HPterm*scrollBar*initialDelay: 10 

HPterm*ScrollBar*RepeatRate: 10 

*ScrollBar*Granularity: 1 

hpterm*scrollBar*width: 20 

Additional resources and information can be found in the XmPrimitive(3X), XmScrollBar(3X), 
XmValuator(3X), and Core(3X) man pages along with additional information about the various 
shadow options. 



Scrollbar Resource Set (name "scrollBar", class '^ScrollBar") 


Name 


Class 


Type 


Default 


background 


Background 


Pixel 


"white" 


bottomShadowColor 


Foreground 


Pixel 


"black" (see below) 


bottomShadowTile 


BottomShadowTile 


string 


"foreground" (see below) 


foreground 


Foreground 


Pixel 


"black" (see below) 


granularity 


Granularity 


int 


2 


initialE)elay 


InitialDelay 


int 


500 


repeatRate 


RepeatRate 


int 


100 


topShadowColor 


Background 


Pixel 


"white" (see below) 


topShadowTile 


TopShadowTile 


string 


"50 foreground" (see below) 


width 


Width 


int 


10 
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background 

This resource defines the background color of the scrollbar window. 

bottomShadowCoIor 

This resource defines the color that is combined with the bottom shadow tile and fore- 
ground color to create a pixmap used to draw the bottom and right sides of the scrollbar 
borders. This may be overridden by the termO makeColors resource described above. 

bottomShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the bottom 
and right shadows for the scrollbar borders. Valid tile names are described in 
XmCreateTile(3X). This maybe overridden by the termO makeColors resource described 
above. 

foreground 

This resource defines the foreground color of the scrollbar window. This may be overrid- 
den by the termO makeColors resource described above. 

granularity 

This resource defines the number of lines to advance the slider when the button is being 
held down on an arrow. The value is defined in milliseconds. 

initialDelay 

This resource defines the delay to wait bettveen the time the button is held down on an 
arrow before the slider starts its repetitive movement. The value is defined in mil- 
liseconds. 

repeatRate 

This resource defines the continuous repeat rate to use to move the slider while the but- 
ton is being held down on an arrow. The value is also defined in milliseconds. 

topShadowColor 

This resource defines the color that is combined with the top shadow tile and foreground 
color to create a pixmap used to draw the top and left sides of the scrollbar borders. This 
may be overridden by the termO makeColors resource described above. 

topShadoWTile 

This resource defines the tile used in creating the pixmap used for drawing the top and 
left shadows for the scrollbar borders. Valid tile names are described in 
XmCreateTile(3X). This maybe overridden by the termO makeColors resource described 
above. 

width This resource defines the width of the scrollbar in pixels. 

POINTER USAGE 

Hpterm allows you to cut and paste text within its own or other windows. All cutting and pasting is 
done using the PRIMARY selection. (To maintain compatability with previous versions of 
hpterm (and other applications that use cut buffers), the cutting and pasting is also done to/from 
the first global cut buffer. When pasting, hpterm gets its text from the PRIMARY selection; if the 
PRIMARY selection is not owned, or the current owner cannot supply the data as text, hpterm will 
try to get its data from the first global cut buffer.) The PRIMARY selection will be disowned 
(and the selected text unhighlighted) under the following conditions: 

1) the cursor is moved anywhere before the end of the selected region 

2) the beginning of the selected region is scrolled off the end of the terminal buffer 

3) the selected region is scrolled across the boundaries of the locked region when 
memory lock is enabled. 

The default button assignments may be changed via various resource strings. The cut and paste 
functions and their default button assignments are: 

Cut The left button is used to "cut" text into the cut buffer. Move the pointer to the 

beginning of the text to cut, press the button, move the cursor to the end of the 
region, and release the button. The "cut" text will not include the character currently 
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under the pointer. 

Paste The middle button "pastes" the text from the cut buffer, inserting it as keyboard 

input 

CopyLine The right hand button "cuts" the text from the pointer (at button release) through 
the end of line (including the new line), saving it in the cut buffer, and immediately 
"pastes" the line, inserting it as keyboard input. This provides a history mechanism. 

The copji^ine, cut, and paste key functions can be configured to any button and modifier combi- 
nation desired via various resources. Each assignment consists of an optional combination of 
modifiers ("none" or any combination of "shift", "meta", "lock", "control", "modi", ..., "mod5" 
separated by blanks), followed by a "|" and the name of the button ("left", "middle", "right", 
"buttonl", ..., "buttons"). For example, if it is desired for the cut function to be associated with 
the middle button with shift and control pressed, one could use the following resource line: 

*cut: shift control | middle 

For a full list of resource names, see "RESOURCES" above. 



NLS 



Hpterm currently supports 23 different language versions of the HP keyboard. It is possible to 
switch between different languages via the "terminal configuration" menu. A list of language to 
choose from along with their order is specified via the "keyboardLanguageList" resource. The 
"keyboardLanguageList" resource consists of a list of keyboard languages separated by spaces, 
tabs, or new lines. Valid keyboard languages may be found in the file "/usr/lib/Xll/XHPlib.h." 
Keyboard languages are specified as the language with the leading "KB_" dropped. The default 
value for the "keyboardLanguageList" resource is "US English Belgian Canada_English Danish 
Dutch Finnish French Canada_French Swiss French German Swiss_German Italian Norwegian 
Euro_Spanish Latin_Spanish Swedish UK_English Katakana Swiss_French2 Swiss_German2 
Japanese Korean S_aiinese T_Chinese." 

The initial keyboard language is specified via the "keyboardLanguage" resource. If the string is 
NULL, the language of the server's keyboard will be used. If the keyboard language specified is 
not included in the keyboardLanguageList resource, the first language included in the key- 
boardLanguageList resource will be used. The default is to use the language of the server's key- 
board. 

Hpterm will try to select default fonts which match your monitor and your keyboard language. If 
the normal (primary) and bold (alternate) fonts are specified, they will be used. If only one is 
specified (via either command line options or resources), it will be used for both the normal (pri- 
mary) and bold (alternate) fonts. If neither normal (primary) or bold (alternate) fonts are 
specified, hpterm trys to find them based on the default keyboard language, llie default keyboard 
language is indicated on the "terminal configuration" menu. The built in defaults maybe overrid- 
den via the "t&TmQ.fontLanguage" resources. FontLangfiage varies with the keyboard language as 
follows. 

keyboard language foruLanguage 

Katakana hp_kana8 

Japanese hpjapanese 

Korean hp_korean 

T_Chinese hp_chinese_t 

S_Chinese hp_chinese_s 

all others HP keyboards hp_roman8 

non HP keyboards iso_8859_l 

The default font size used will depend upon the resolution of the monitor as follows: 
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monitor resolution font size 

72 DPI or less low 

greater than 72 DPI and less 100 DPI medium 
100 DPI or greater high 

For example, resource specifications for the USEnglish, German, and Finnish keyboards would 
be: 

HPterm*hp_roman8.primaiy.high: *courier-medium-r-normal-14*hp-roman8 

HPterm*hp_roman8.primaiy.medium: •courier-medium-r-normal-12*hp-Toman8 

HPterm*hp_Toman8.primaiy.low: *courier-medium-r-normal— 8*hp-roman8 

HPterm*hp_roman8.altemate.high: •courier-bold-r-normal-14*hp-roman8 

HPterm*hp_roman8.altemate.medium: *courier-bold-r-normal— 12*hp-roman8 

HPterm*hp_roman8.altemate.low: *courier-bold-r-normal— 8*hp-roman8 

For the Japanese keyboard, resource specifications would be: 

HPterm*hpJapanese.primary.high: jpn.8xl8 

HPterm*hpJapanese.primary.medium: jpn.8xl8 

HPterm *hp Japanese.primary.low: jpn.8xl8 

HPterm*hpJapanese.altemate.high: math.8xl8 

HPterm*hpJapanese.altemate.medium: math.8xl8 

HPterm*hpJapanese.altemate.low: math.8xl8 

If these fonts can not be found, the font "fixed" will be used for both the normal (primary) and 
bold (alternate) fonts. These resources are for font defaults only and will be ignored if either the 
normal (primary) or bold (alternate) fonts are specified. 

Control-N will switch to the bold (alternate) font and control-O will switch back to the normal 
(primary) font. Hpterm will switch back to the normal (primary) font automatically at the begin- 
ning of each line. 

XCONSOLES 

It is possible to configure a system to allow redirection of console output (and input) to an hpterm 
window. If the "-C" option is used, hpterm will redirect console output (and input) if: 

Hpterm is displaying on the local system. Hpterm must be running on the same system as 
the server that is displaying the window. 

The display i$ authorized. The display number of the display name (see "Display 
Specification" in ^(1)) must be authorized to take control of the console via the file 
"/usr/lib/Xll/Xconsoles." The file is parsed as follows: 

A '#' and all following text on a line are ignored. 

Blank lines are ignored. 

Leading tabs and spaces are ignored. 

A number matching the display number authorizes the server to redirect con- 
sole output (and input). 

An asterisk ('*') matches all display numbers and authorizes the server to 
redirect console output (and input). 

If either condition is not met, a warning will be written to stderr and console output (and input) 
will not be redirected. 

WARNINGS 

When running block mode applications, it maybe necessary for hpterm to identify itself to applica- 
tion programs as some terminal other than "X-hpterm." Most applications understand the 
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terminal id "2392A." Newer applications also understand the terminal id "700/92" while older 
applications may only understand the terminal id "2622A." To set the terminal identification 
string, use the "-ti" command line option, the "termld" resource, or the "Termid" class. 

The overflow protect mode of memory lock is not supported. 

ENVIRONMENT 

Hpterm sets the environment variables "$LINES" and "SCOLUMNS" to the number of lines and 
columns of the terminal screen. It also uses and sets the environment variable "$DISPIAY" to 
specify its server connection. The resize(l) command may be used to reset "SLINES" and 
"SCOLUMNS" after the window size has been changed. 

ORIGIN 

Hewlett-Packard Company ETO. 

SEE ALSO 

X(l), resize(l), xset(l), xterm(l), pty(4), Core(3X), XmScrollBar(3X), XmPriinitive(3X), 
XmCreateTile(3X), XmVaIuator(3X), XinArrow(3X). 
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NAME 



vuecommand - provide execution support for Viie products. 



SYNOPSIS 

vuecommand [options] 

OPTIONS 

-mincache n 

Specifies the number of terminal windows that are prestarted. This is also the minimum 
number of terminal windows to cache. The default is zero. Note that increasing this 
default (perhaps to two), will result in an increased login time, while improving initial 
terminal start up time. 

•maxcache n 

Specifies the maximum number of terminal windows to cache. The default is four. 

•terminal <terminal_emulator> 

Specifies the terminal emulator to use for the terminal caching. The default is 
/usr/bin/Xll/hpterm. 

-help Prints the usage and then exits. 

DESCRIPTION 

Vuecommand is an HP VUE daemon which accepts requests to invoke operating system com- 
mands and to start applications which create their own windows. The output from the commands 
can be displayed in several window types including a terminal emulation window and a shared out- 
put window. The commands and applications can be started on any host which is properly 
configured to run HP Vue. 

Vuecommand uses HP's Xll terminal emulator (see hpterm (1)) to display the output for all of its 
non-window smart requests. For performance reasons, vuecommand caches the terminal emula- 
tors. A fixed number of terminal windows are "pre-started" in an unmapped condition and when 
needed, the terminal windows are mapped with output from the associated request. When the 
user closes a terminal window -vuecommand unmaps the window and reuses it. To change the 
appearance or behavior oivuecommand's windows, set the appropriate resource for hpterm. 

RESOURCES 

Vuecommand uses the following resources: 



HP VUE Vuecommand Resource Set 



Name 



Class 



lype 



Default 



maxCache 

mapWindow 

minCache 

outputOnlylcon 

outputOnlyName 

permTerminallcon 

permTerminalName 

sharedOutputlcon 

sharedOutputName 

shellTerminallconShell 



MaxCache 

MapWindow 

MinCache 

OutputOnlylcon 

OutputOnlyName 

PermTerminallcon 

PermTerminalName 

SharedOutputlcon 

SharedOutputName 

Terminallcon 



int 4 

Boolean True 

int 

XmString Output 

XmString Output Only Window 

XmString Perm-Term 

XmString Permanent Terminal Window 

XmString Shared 

XmString Shared Output Window 

XmString Terminal 
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shellTerminalName ShellTerminalName XmString Terminal Window 

terminal Terminal XmString /usr/bin/Xll/hpterm 

terminallcon Terminallcon XmString Terminal 

terminalName TerminalName XmString Terminal Window 



maxCache 

Specifies the maximum number of terminal windows to cache. 

mapWindow 

Specifies whether vuecommand should e}q)licitly map the terminal windows. If this 
resource is set to False, the terminal emulator's "mapOnOutput" must be set to True (it is 
False by default). If both of these resources are False, an action may not get its' window 
mapped. 

minCache 

Specifies the number of terminal windows that are prestarted. This is also the minimum 
number of terminal windows to cache. 

outputOnlylcoit 

Specifies the icon title for output only requests. 

outputOnlyName 

Specifies the window title for output only requests. 

permTerminallcon 

Specifies the icon title for permanent terminal requests. 

permTerminalName 

Specifies the window title for permanent terminal requests. 

sharedOutputlcon 

Specifies the icon title for shared output requests. 

sharedOutputName 

Specifies the window title for shared output requests. 

terminal 

Specifies the terminal emulator to use. 

shellTerminallcon 

Specifies the icon title for shell terminal requests. 

shellTerminalName 

Specifies the window title for shell terminal requests. 

terminallcon 

Specifies the icon title for terminal requests. 

terminalName 

Specifies the window title for terminal requests. 

MISCELLANEOUS 

Error messages produced by vuecommand are logged in the file $HOME/.vue/errorlog. 

Login (1) cannot be run in vuecommand's cached terminals. 

ENVIRONMENT 

Vuecommand uses the $DISPLAY environment variable. 

COPYRIGHT 

Copyright 1990 Hewlett-Packard Company. 
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ORIGIN 

Hewlett-Packard Company ITO. 



RELATED INFORMATION 

X(l), vaerde(lX), liptenii(lX). 
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NAME 

vuefUe - The HP VUE File Manager. 

SYNOPSIS 

vuefUe [options] 

DESCRIPTION 

The HP VUE File Manager (yuefile) is HP VUE's primary interface to the file system. It pro- 
vides application ejKcution and file manipulation. 

The File Manager can display many main windows, each of which contains the files of a single 
directory. Each file is presented as a labeled icon. A menu bar provides file operations. 

A direct manipulation paradigm is used to perform operations on the displayed files. Double- 
click performs a specified action on a file. Selection and multiple selection activate a file or a set 
of files. This is primarily used to indicate the active object for menu operations. Multiple selec- 
tion is also used by drag for defining the set of files to be dragged. Drag is used to copy or move a 
file or files between File Manager windows. It is also used to drag data to another cooperating 
client. 

opnoNS 

VuefUe defines three command-line options that can be used when vuefile is run. 

-noview 

This runs vuefile in "server mode," which means that no directory views are initially 
displayed. Vuefile waits for a cooperating client to tell it to display a view. 

-session session file 

This option takes the name of a session file as an additional parameter. Vuefile is run with 
the specified session file name. The session file is a file that was previously saved by 
vuefile through a session shutdown. 

-dir directory 

This option takes a single or multiple directory specification as an additional parameter. 
This specification is of the form hostname:path,hostname:path,... or path,path,... or any 
combination of the two (no spaces are allowed in the additional parameter string). This 
option runs vuefile and causes it to display a directory view for each directory specified. 

Both the -noview and -session options are normally used by the session manager to start vuefile. 

The command-line options are treated exclusively and have a priority of session, dir, noview. If 
more than one of the options is specified, the lower priority option(s) is(are) ignored. \i vuefile is 
run with no command-line parameters, the user's current directory is displayed. 

FILE TYPES and ACTIONS 

Each File Manager main window displays a set of icons, each representing a single file. Each file 
has an associated file type that is determined by the file name: data file, executable file, or direc- 
tory. The set of file types defined for the File Manager are contained in the users and system file 
type files. 

Each file type has a set of actions defined for it. An action is an executable or application that can 
be run with a file of that type. To make the action readily available, each of the actions defined 
for a file type are displayed in an Actions menu pane in the File Manager's main window. The set 
of actions defined for the File Manager are contained in the users and system action files. 

Refer to HP Visual Environment System Administration Manual for a description of file type and 
action files. 
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FEATURES 

Opening a File 

Double-clicking a file opens it, which causes the default action defined for the file type of 
the file to be run. By default, opening an application will execute it, opening a directory 
will cause the contents of the directory to be displayed, and opening a data file will cause 
a text editor to be run with the data file being edited. 

Draggii^ a File 

A file or set of files can be dragged to another File Manager window or to any other 
cooperating client. This provides for file copy, move and execution. 

File Filterii^ 

Directories can contain files of many different types and sizes. The File Manager's filter- 
ing mechanism provides the means by which the user can selectively display sets of files. 
The types of filtering available include: by type, by size, by modification (or creation) 
date. 

Directory TVaversal 

Simple directory traversal is available by double-clicking a directory icon. This displays 
the contents of the directory. The File Manager provides a display mode that displays the 
directory hierarchy as a graph that can be easily traversed. A dialog is also available that 
can search the file system for a directory or directories matching user-supplied search cri- 
teria. Another dialog can be used to list directories frequently used; a double-click on a 
directory in the list changes to that directory. 

Setting Display Preferences 

Both iconic and non-iconic visual representations for file display are provided. The non- 
iconic form can be used to display directories with large numbers of files or where display 
space is at a premium. 

Finding Files 

Directories can be searched for a file or set of files that match search criteria. Search cri- 
teria can include file name, size and modification (or creation) date. When files are 
located, a File Manager window opens to display the directory that contains the file. 

Smart Trash Can 

The File Manager provides access to VUE's smart trash can. The user can place files 
into the trash can, but they are not permanently removed until the user asks that the trash 
can be emptied or the HP VUE session is terminated at logout. Files dragged to the 
trash can also be restored, but only during the current session (before logout) and before 
being permanently removed. 

COPVRIGHT 

Copyright 1990 Hewlett-Packard Company. 

ORIGIN 

Hewlett-Packard Company ETO. 
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NAME 

vuehello • The HP VUE Startup Transition Program. 

SYNOPSIS 

vuehello [options] 

DESCRIPTION 

Vuehello is a client that provides a transitory visual during the start up of the Hewlett-Packard 
Visual User Environment (HP VUE). Vuehello is designed to cover the interval between login 
(see vuelogin(lX)) and the start up of the window manager (see vuewm(lX)). 

Vuehello covers the screen with a window and displays a message centered in the screen. The mes- 
sage consists of two parts. The first part is a short welcome string. This string may contain literal 
new-line characters. The second part is the content of one or more (up to five) files. Each line of 
text from these two parts is centered on the screen. 

Vuehello will only keep the first 100 lines of text it accumulates. It does not scroll or try to prevent 
the text from getting clipped if the text does not fit on the screen. 

Vuehello is designed to be invoked just after login. A reasonable file to contain the invocation of 
vuehello is /usr/lib/Xll/Vuelogin/Xsession. 

OPTIONS 

-display display jiame 

This option names the display on which to run. The default display is taken from the 
$DISPLAY environment variable. 

-bg background j:olor 

This option specifies the background color of the window. The default value is "black" 
for B&W and screens with limited color (16 or less) and "comftowerblue" for screens 
with more colors (more than 16). The background color can also be specified by setting 
the background (class Background) resource. 

-fgforegfound_color 

TTiis option specifies the foreground color (for the text). The default value is "white." 
The foreground color can also be specified by setting the for^round (class Foreground) 
resource. 

Si<tfilejiame 

This option specifies a file from which to read message text. This option may appear up 
to five times to include text from five different files. Vuehello keeps only the first 100 
lines of text from the combination of the message string and files. Each line is centered 
on the screen. If no file option is specified, the file "/etc/copyright" is displayed. The 
file (class File) resource is recognized, but only one file can be specified this way. 

-tontfontjiame 

This option specifies the font to use with which to render the text string. The default 
value is "system23." The equivalent resource is font (class Font). 

-strii^ text_string 

This option specifies the message text to display. Messages with embedded spaces must 
be quoted. Literal new-line characters can be embedded in the text string to specify line 
breaks. Each line will be centered on the screen. The default text is: 

Starting the 

Hewlett-Packard 

Visual User Environment 

The message text can also be specified with the string (class String) resource. 
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-timeout numjeconds 

This option specifies the timeout value in seconds. Vuehello sets a timer and then waits 
for the ReparentNotify event that signals that the window manager is up. If the timer 
expires, vuehello stops waiting on the window manager and terminates immediately. The 
default value is 240 seconds. The equivalent resource is timeout (class Timeout). 

ENVIRONMENT 

Vuehello may use the SDISPLAY environment variable. 

FILES 

/usr/lib/Xll/vue/Vuelogin/Xsession 
/usr/lib/Xll/vue/Vuelogin/Xstartup 

COPYRIGHT 

(c) Copyright 1990 by Hewlett-Packard Company. 
All rights reserved. 

ORIGIN 

Hewlett-Packard Company ITO. 

RELATED INFORMATION 

vuelogin(lX), vuewm(IX). 
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NAME 

vuehelp - The VUE Help Manager. 

SYNOPSIS 

vuehelp [options] 

DESCRIPTION 

The HP VUE Help Manager (vuehelp) is an Xll Motif client that provides access to on-line help 
documentation. Vuehelp can be run standalone or started via an application. The Help Manager 
is used by all HP VUE Tools and is accessible by any other motif application via the Help API. 

The Help Manager is based on a shared window help facility. All tools using the Help Manager 
will share its two main windows. As a result of this shared window facility, the Help Manager will 
let only one executable per display run at a time. This one executable will service all incoming 
help requests. 

The Help Manager has two main windows: Help Index and Help Viewer. The Help Index window 
serves as a browser into the system's on-line help documentation. The Help Viewer window 
allows the user to view specific help files, system documentation, and s)fstem man pages. 

Two other Help windows are also provided for static text viewing: Snapshot window and File 
Viewer window. The Snapshot window allows the user to copy the current help text from the 
Help Viewer and 'post it' on the screen in a snapshot window for prolonged viewing. The File 
Viewer window (called from the File Manager, vuefile (IX)), allows the user to view an ASCII text 
file. 

OPTIONS 

-^ helpFilePath/CatFile 

This option specifies the help system to display in the Help Viewer the given help file 
"CatFile". "helpFilePath" must be relative to the 'tools' directory in the Help file tree. 

-unmapped 

This option specifies that the help system be started and initialized in an unmapped 
state. 

RESOURCES 

Vuehelp uses the following resources: 

HP VUE Help Files Resource Set 
Name Class Type Default 



fileSize FileSize Xmint 512000 

helpFiles HelpFiles XmString Default 
searchPath SearchPath XmString Application must Set 

fileSize This resource is set to a default value of 512000 characters. The Help Manager File 
Viewer can deal with much larger files. However, the resources required can cause severe 
performance degradation while the Help Manager is processing the file. 

helpFiles 

This resource is used to set the absolute path to the help files located on your system. The 
default resource path is "/usr/lib/Xll/vue/help" (default language is 'C'). 

searchPath 

This resource must be defined in the application's app-defaults file. It is a relative path 
from the 'tools' directory within the Help file tree pointing to the application's help files. 
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HP VUE Help Fonts Resource Set 
Name Class Type Default 

systemFont SystemFont FontList Default 
userFont UserFont FontList Default 

systemFont 

This resource is used for setting text portions of the interface that are not user manipu- 
lated (e.g. labels, buttons, titles). 

userFont 

This resource is used for setting text portions of the interface that are manipulated by the 
user (e.g. Text Edit areas). 

APPEARANCE 

The following sections describe the basic default behavior of the di£ferent types of VUE Help sys- 
tem windows. The appearance and behavior of these windows will only change based on the Help 
text being viewed. 

HELP VIEWER WINDOW 

The HP VUE Help server builds and manages one Help Viewer window. This window is shared 
by all applications/tools using the Help system. 

The first invocation of help from within a workspace causes the Help Server to map the Help 
Viewer window in that workspace. If the Help Viewer window is already mapped in the 
workspace, the Help server repaints the new help text in the window. The window is resizable by 
the user; however, it has a default minimum size. 

The Help Viewer window contains four areas. From top to bottom they are: 

Pulldown Menu Bar The menu bar contains three menu buttons (File, Browse, and Help) used 
for accessing the menu items available within the Help Viewer window. 

Text This area contains a scrollable Help text document that relates to the pre- 

viously selected function. 

Related Topics This area contains a scrollable list of related topics. 

History and Options This area contains two buttons and a menu. Two buttons for history mani- 
pulation and a menu to access the Word Search, Man Page Search and 
Glossary options. 

HELP INDEX WINDOW 

The Help server builds and manages one Help Index window. This window is shared by all 
applications/tools using help. 

Invoke the Help Index from the "?" button in the workspace manager or from a Help Viewer's 
Browse menu. If the Help Index is already mapped in the current workspace, the Help server 
repaints the new help index information in the existing Help Index window. If the Help Index 
exists but is unmapped or in another workspace, the Help server updates the text and maps the 
window in the current workspace. The window is resizable by the user; however, it has a default 
minimum size. 

The Help Index window contains three areas. From top to bottom they are: 

Pulldown Menu Bar The pulldown menu contains two menu buttons (File, Help) used for 
accessing the menu items available within the Index Window. 

Index This area contains a scrollable index of help topics and navigation buttons. 

Viewer and Search This area contains two buttons: Viewer and Show Search Option. The 
Viewer button opens the Help Viewer window, and the Show Search 
Option shows the Index area search option. 
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Word Search 



Command Options 



HELP SNAPSHOT WINDOW 

The Help Snapshot window provides the user with a means of saving a copy of the current Help 
Viewer help text. The user creates a snapshot from the Help Viewer window by selecting 
•Snapshot" (camera) button on the Help Viewer window. At any given time, a user may have 
numerous snapshots and one Help Viewer window. 

Help Snapshot windows do not browse further into the help system, but the do support all the 
other Help window functions: text scrolling, word searching, and printing. The intent of the 
snapshot windows are to give the user the ability to compare/save multiple Help text views at the 
same time. 

Once a Snapshot window is created, its existence is managed by the user. That is, it will be the 
user's responsibility to close the view. Exiting the Help Window will leave any snapshot windows 
intact. 

The Snapshot window contains three areas. From top to bottom they are: 

Text This area contains a copy of the Help text in the current Help Viewer win- 

dow. 

A word search mechanism provided here is the same as the word search 
mechanisms in the Help window. The intent is to give the user the ability 
to search through the Snapshot window Help text for a user-selected word 
or phrase. The Find Next and Find Previous buttons allow the user to 
search forwards and backwards within the text for the given word or 
phrase. As each instance of the search string is found, it is highlighted. 

This area displays three buttons: a Print button, which prints a copy of the 
current Snapshot Help-Text; a Help button, which causes the Help Viewer 
window to display help information about the Snapshot Window; and a 
Close button, which closes the window. 

FILE VIEWER WINDOW 

The File Viewer Window provides an application with a means of viewing a text file in a window. 
Access the File Viewer window from the File Manager (yuefile (IX)) by choosing "VIEW" from 
the "Actions" menu. There is no direct way via the help system that a user can request that a file 
be viewed. Files may only be viewed by an application making the proper help API call. The File 
Viewer window lool^ and works just like the Snapshot windows. 

Once a File Viewer is created, its existence is managed by the user. That is, it is the user's respon- 
sibility to close the view. 

The File Viewer window contains three areas. From top to bottom they are: 

Text This area contains the text of the file requested. 

Word Search A word search mechanism provided here is the same as the word search 

mechanisms in the Help Window. This allows the user the ability to 
search through the File Viewer text for user-selected words or phrases. 
The Find Next and Find Previous buttons allow the user to search for- 
wards and backwards within the text for the given word or phrase. As each 
instance of the search string is found, it is highlighted. 

Command Options This area displays three buttons: a Print button, which prints a copy of the 
current File View Help-Text; a Help button, which causes the Help Win- 
dow to display help information about the File Viewer window; and a 
Close button, which closes the window. 
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X DEFAULTS 

VUE Help is configured bom its resource database. This database is built from the following 
sources. They are listed in order of precedence, low to high: 

app-defaults/Vuehelp 

RESOURCE MANAGER root window property or $HOME/.vue/vue.resources 

XENVIRONMENT variable or $HOME/.vue/vue.resources 

Entries in the resource database may refer to other resource files for specific types of resources. 

Vdehelp is the resource class name ofvuehelp and vuehelp is the resource name used by vuehelp to 
look up resources. 

COPYRIGHT 

(c) Copyright 1989 by Open Software Foundation, Inc. 

(c) Copyright 1987, 1988, 1989 by Hewlett-Packard Company 

All rights reserved. 

ORIGIN 

Hewlett-Packard Company ITO. 

SEE ALSO 

X(l), vuerile(lX). 
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NAME 

vuelogin - The HP VUE Login Manager. 

SYNOPSIS 

vuelogin [-config configuration Jile] [-daemon] [-debug debugjevel] [-error error Jogjile] [- 
nodaemon] [-resources resource Jile] [-server server_entry] [-session session jprogfam\ 

DESCRIPTION 

Vuelogin manages a collection of X displays, both local and possibly remote. The emergence of X 
terminals guided the design of several parts of this system, along with the development of the X 
Consortium standard XDMCP ( XDispU^ Manager Control Protocol). Vuelogm provides services 
similar to those provided by initilM), getty(\M) and loffn(l) on character terminals: prompting 
for login and password, authenticating the user, and running a "session." 

A "session" is defined by the lifetime of a particular process; in the traditional character-based 
terminal world, it is the user's login shell process. In the HP VUE context, it is the HP VUE Ses- 
sion Manager. This is because in a windowing environment, a user's login shell process does not 
necessarily have any terminal-like interface with which to connect 

If the HP VUE Session Manager is not used, the typical vuelogm substitute is either a window 
manager with an exit option, or a terminal emulator running a shell, where the lifetime of the ter- 
minal emulator is the lifetime of the shell process that it is running; thus reducing the X session to 
an emulation of the character-based terminal session. 

When the session is terminated, vuelogin resets the X server and (optionally) restarts the whole 
process. 

Because vuelogin provides the first interface that users see, it is designed to be simple to use and 
easy to customize to the needs of a particular site. 

OPTIONS 

All options, except -conHg, specify values that can also be specified in the configuration file as 
resources. Typically, customization is done via the configuration file rather than command line 
options. The options are most useful for debugging and one-shot tests. 

-config configuration JUe 

Specifies a resource file that specifies the remaining configuration parameters. If no file 
is specified and the file /usr/ lib /Xll/vue /Vuelogin /Xconfig exists, vuelo^n uses it. 

-daemon 

Specifies "true" as the value for the daemonMode resource. This makes vuelogin close all 
file descriptors, disassociate the controlling terminal and put itself in the background 
when it first starts up (just like the host of other daemons). 

-debug debugjevel 

Specifies the numeric value for the debugLevel resource. A non-zero value causes vuelo- 
gin to print piles of debugging statements to the terminal; it also disables the daemon- 
Mode resource, forcingvuelogin to run synchronously. 

-error error Jogjile 

Specifies the value for the errorLt^ile resource. This file contains errors from vuelo^n 
as well as anything written to stderr by the various scripts and programs run during the 
progress of the session. 

-nodaemon 

Specifies "false" as the value for the daemonMode resource. 

•resources resource Jile 

Specifies the value for the resources resource. This file is loaded using xrdb (1) to specify 
configuration parameters for the authentication screen. 

-server server _entty 

Specifies the value for the servers resource. See servers below for more detail. 
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•ndpPort portjtumber 

Specifies the value for the requestPort resource. This sets the port-number that vuelogln 
monitors for XDMCP requests. Since XDMCP uses the registered well-known udp port 
177, this resource should probably not be changed except for debugging. 

-session session _progf am 

Specifies the value for the session resource. This indicates the program to run when the 
user has logged in as the session. 

CONTROLLING THE SERVER 

Vuelo^n controls local servers using POSIX signals. SIGHUP is expected to reset the server, clos- 
ing all client connections and performing other clean up duties. SIGTERM is e}q)ected to ter- 
minate the server. If these signals do not perform the expected actions, vuelofftt does not perform 
properly. 

To control remote servers not using XDMCP, vuelofftt searches the window hierarchy on the 
display and uses the KillQient protocol request in an attempt to clean up the terminal for the next 
session. This may not actually kill all of the clients, since only those that have created windows are 
noticed. XDMCP provides a more sure mechanism; when vuelogin closes its initial connection, 
the session is over and the terminal is required to close all other connections. 

CONTROLLING VUELOGIN 

Vuelogln responds to two signals: SIGHUP and SIGTERM. Whert sent a SIGHUP, vuelogln 
rereads the configuration file and the file specified by the servers resource and determines 
whether entries have been added or removed. If a new entry has been added, vuelogln starts a ses- 
sion on the associated display. Entries that have been removed are disabled immediately, mean- 
ing that any session in progress is terminated without notice, and no new session is started. 

When sent a SIGTERM, vuelogln terminates all sessions in progress and exits. This can be used 
when shutting down the system. 

ENVIRONMENT 

Vuelogln invokes the user's session with the following default environment: 

DISPLAY is set to the associated display name 

EDITOR is set to /usr/bin/vi 

HOME is set to the home directory of the user 

LANG is set to the current NLS language (if any) 

LOGNAME is set to the user name 

MAIL is set to /usr/mail/$USER 

PATH is set to the value of the userPath resource 

USER is set to the user name 

SHELL is set to the user's default shell (from /etc/passwd) 

TERM is set to hpterm 

TZ is set to the value of the timeZone resource 

XAUTHORTTY may be set to an authority file 

Three methods are available to modify or add to this list depending on the desired scope of the 
resulting environment variable. 

The environment resource is available in the vuelogln configuration file to allow setting of 
environment variables on a global or per-display basis. Variables specified by this method are 
available to both the display's X server process and the user's session and override any default set- 
tings. The resource accepts a string of <name> = < value > pairs separated by at least one space 
or tab. The values specified must be constants because no shell is used to parse the string. See the 
RESOURCES section below for details on setting this resource. 

For example: 
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Vuelogin*environment: 



SB_DISPLAY_ADDR=OxBOOOOO \ 
WMSHMSPC=0x200000 



Note: The environment variables LANG and TZ have their own dedicated resources in the 
configuration file and should not be set via environment. 

Environment variables that require processing by a shell or are dependent on the value of another 
environment variable can be specified in the startup script Xsession. These variables are loaded 
into the environment of all users on the display, but not to the X server process. They override 
any previous settings of the same variable. The Xsession script accepts ksh syntax for setting 
environment variables. 

For example. 

MAIL = /usr/mail/$USER 

Finally, personal environment variables can be set on a per-user basis in the script file 
%\iOME/.vueprofile. Vuelogln accepts either sh, ksh, or csh syntax for the commands in this file. 
The commands should only be those that set environment variables, not any that perform terminal 
I/O, excepting tset{l) or sttyQ). If the first line of .vueprofUe is #!/bin/sh, #!/bin/ksh, or 
#!/bin/csh, vueloffn uses the appropriate shell to |>arse .vueprofUe. Otherwise, the user's default 
shell ($SHELL) is used. 

INTERNATIONALIZATION 

All labels and messages are localizable. The message catalog vuelogtn.cat contains the localized 
representations of the default labels and messages. Vuelogin reads the appropriate message cata- 
log indicated by the LANG environment variable and displays the localized strings. An option on 
the authentication screen allows the user to override the default language for the subseqent ses- 
sion. If the authentication screen has been localized for the selected language, it is redisplayed in 
that language; otherwise, it is displayed in the default language. In either case, the LANG environ- 
ment variable is set appropriately for the resulting session. 

A resource language is available in the vuelogln configuration file to change the default language 
for a display. 



RESOURCES 

The actions oivuelo^n can be controlled through the use of various configuration files, which are 
in the X resource format. Some resources control the behavior of vuelogin in general, some can 
be specified for a particular display, and others control the appearance of the authentication 
screen. The general and display-specific resources are specified in the configuration file named 
by the -config command line option. All resources should be prepended with the application 
name Vuelogin. 



Name 



Class 



Vuelogin General Resource Set 



Type 



Default 



autoRescan 


AutoRescan 


Boolean 


True 


daemonMode 


DaemonMode 


Boolean 


False 


debugLevel 
errorLogFile 
keyFile 
lockPidFile 


DebugLevel 
ErrorLogFile 
KeyFile 
LockPidFile 


Int 

String 
String 
Boolean 



NULL 

/usr/lib/Xll/vue/Vuelogin/Xkeys 
True 


pidFile 
remoteAuthDir 


PidFile 
RemoteAuthDir 


String 
String 


NULL 
/usr/lib/Xll/vue/Vuelogin 
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removeDomainname RemoveDomainname Boolean True 

requestPort RequestPort Int 177 

servers Servers String :0 Local local /usr/bin/Xll/X :0 

timeZone TimeZone String MST7MDT 

The vueloffn general resources are not display-specific and are applied to all displays where 
appropriate. 

autoRescan 

This boolean controls whether vuelogfn rescans the configuration file and server file after 
a session terminates and the files have changed. You can force vuelogin to reread these 
files by sending a SIGHUP to the main process. 

daemonMode 

Normally, vuelogin attempts to make itself into an unassociated daemon process. This is 
accomplished by forking and leaving the parent process to exit, then closing file descrip- 
tors and mangling the controlling terminal. This is inconvenient when attempting to 
debug vuelogin. Setting this resource to "false" disables daemonMode 

debugLevel 

A non-zero value specified for this integer resource enables reams of debugging informa- 
tion to be printed. It also disables daemon mode, which redirects the information into the 
bit-bucket. Specifying a non-zero debug level also allows non-root users to run vuelogin, 
which is not normally useful. 

errorLogFile 

Error output is normally directed at the system console. To redirect it, set this resource 
to any file name. A method to send these messages to syslog should be developed for sys- 
tems that support it; however, the wide variety of "standard" interfaces precludes any 
system-independent implementation. This file also contains any output directed to stderr 
by Xstartup, Xsession and J&eset, so it contains descriptions of problems in those scripts as 
well. 

keyFile XDM-AUTHENTICATION-1 style XDMCP authentication requires that a private key be 
shared between vuelogin and the terminal. This resource specifies the file containing 
those values. Each entry in the file consists of a display name and the shared key. By 
default, vuelogin does not include support for XDM-AUTHENTICATION-1 because it 
requires DES, which is not generally distributable. 

lockPidFile 

This is the resource that controls whether vuelogin uses file locking to prevent multiple 
logins. 

pidFile The filename specified is created to contain an ASCII representation of the process-id of 
the main vuelogin process. This is quite useful when reinitializing the system. Vuelogin 
also uses file locking to attempt to prevent more than one daemon running on the same 
machine. 

remoteAuthDir 

This is a directory name that vuelogin uses to temporarily store authorization files for 
displays using XDMCP. 

removeDomainname 

When computing the display name for XDMCP clients, the resolver typically creates a 
fully qualified host name for the terminal. As this is sometimes confusing, vuelogin 
removes the domain name portion of the host name if it is the same as the domain name 
for the local host when this variable is set. 

requestPort 

This indicates the UDP port number that vuelogin uses to listen for incoming XDMCP 
requests. Unless you need to debug the system, leave this with its default value. 



Hewlett-Packard Company - 4 - HP VUE 2.01 (10/91) 



VUELOGIN(IX) 



VUELOGIN(IX) 



servers This resource either specifies a file name full of server entries, one per line (if the value 
starts with a slash), or a single server entry. Each entry indicates a display that should 
constantly be managed and that is not using XDMCP. Each entry consists of at least 
three parts: a display name, a display class, a display type, and (for local servers) a com- 
mand line to start the server. A typical entry for local display number is: 

:0 Local local /usr/bin/Xll/X :0 

The display types are: 

local a local display, i.e. one that has a server program to run 

foreign a remote display, i.e. one that has no server program to run 

The display name must be something that can be passed in the -display option to any X 
program. This string is used in the display-specific resources to specify the particular 
display, so be carefiii to match the names (e.g., use ":0 local /usr/bin/Xll/X :0" instead 
of "localhost:0 local /usr/bin/Xll/X :0" if your other resources are specified as 
"Vuelogin._0.session"). The display class portion is also used in the display-specific 
resources as the class portion of the resource. This is useful if you have a large collection 
of similar displays (a group of X terminals, for example) and want to set resources for 
groups of them. When using XDMCP, the display is required to specify the display class, 
so perhaps your X terminal documentation describes a reasonably standard display class 
string for your device. 

timeZone 

This resource specifies the local time zone for vuelogin. It is loaded into the environment 
of vuelogin as the value of the variable TZ and inherited by all subsequent sessions. 

Note: The TZ environment variable is often also set in the file /etc/profile for terminal 
based logins. The system administrator should ensure that the two settings are identical. 



Name 



Class 



Vuelogin Display Resource Set 
Type Default 



authorize 


Authorize 


Boolean 


False 


authName 


AuthName 


String 


MIT-MAGIC-COOKIE-1 


authFile 


AuthFile 


String 


/usr/lib/Xll/vue/Vuelogin/auth-server 


cpp 


Cpp 


String 


/lib/cpp 


environment 


Environment 


String 


NULL 


failsafeClient 


FailsafeClient 


String 


/usr/bin/Xl 1/xterm 


gettyLine 


GettyLine 


String 


console 


getlySpeed 


GetfySpeed 


String 


console 


grabServer 


GrabServer 


Boolean 


True 


grabTimeout 


GrabTimeout 


Int 


3 sec. 


language 


Language 


String 


NULL 


openDelay 


OpenDelay 


Int 


5 sec. 


openRepeat 


OpenRepeat 


Int 


5 sec. 


openTimeout 


OpenTimeout 


Int 


30 sec. 


pinglnterval 


Pinglnterval 


Int 


5 min. 


pingTimeout 


PingTimeout 


Int 


5 min. 


reset 


Reset 


String 


NULL 


resetForAuth 


ResetForAuth 


Boolen 


False 


resetSignal 


Signal 


Int 


1 (SIGHUP) 


resources 


Resources 


String 


NULL 


session 


Session 


String 


NULL 
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startAttempts StartAttempts Int 



startup 


Startup 


String 


NULL 


sjstemPath 


SystemPath 


String 


/usr/bin/Xll:/bin:/usr/bin:/etc 


systemShell 


SystemShell 


String 


/bin/sh 


terminateServer 


TerminateServer 


Boolean 


False 


tennSignal 


Signal 


Int 


15 (SIUliiRM) 


userAuthDir 


UserAuthDir 


String 


/tmp 


userPath 


UserPath 


String 


/usr/bin/Xll:/bin:/usr/bin:/usr/contrib/bin:/usr/local/b 


xrdb 


Xrdb 


String 


/usr/bin/Xll/xrdb 



vueloffti display resources can be specified for all displays or for a particular display. To specify a 
particular display, the display name is inserted into the resource name between "Vuelogin" and 
the final resource name segment. For example, 'Viielogin.eji]>o_0.startup is the name of the 
resource defining the startup shell file on the "expo:Q" display, llie resource manager separates 
the name of the resource from its value with colons, and separates resource name parts with dots, 
so vuelogin uses underscores for the dots and colons when generating the resource name. 

Resources can also be specified for a class of displays by inserting the class name instead of a 
display name. A display that is not managed by XDMCP can have its class affiliation specified in 
the file referenced by the servers resource. A display using XDMCP supplies its class affiliation 
as part of the XDMCP packet. 



authorize 

authorize is a boolean resource that controls whether vuelogin generates and uses author- 
ization for the server connections. (See authName.) 

authName 

If authorize is used, authName specifies the type of authorization to be used. Currently, 
vuelogin supports only MIT-MAGIC-COOKIE-l authorization, XDM- 
AUTHORIZATION-1 could be supported, but DES is not generally distributable. 
XDMCP connections state which authorization types are supported dynamically, so auth- 
Name is ignored in this case. (See authorize.) 

authFile 

This file is used to communicate the authorization data from vuelogin to the server, using 
the -auth server command line option. It should be kept in a write-protected directory to 
prevent its erasure, which would disable the authorization mechanism in the server. 

cpp This specifies the name of the C preprocessor that is used by xrdb. 

environment 

This resource can contain a set of <name> = < value > pairs separated by a space or tab. 
Each item is loaded into the environment of the server and session. See ENVIRON- 
MENT for details. 

failsafeClient 

If the default session fails to execute, vuelog.n falls back to this program. This program is 
executed with no arguments, but executes using the same environment variables as the 
session would have had. (See The Xsession File below.) 

gettyLine (See gettySpeed.) 

gettySpeed 

On local bitmaps, the user may choose a "No Windows" option via the login screen, which 
temporarily suspends the server and runs a standard login sequence (getty/login) on the 
bitmap. ITie user can then log in and perform non-X related tasks. When the user 
finishes and logs out, the server restarts, and the vueloffn screen is redisplayed. The get- 
tyLine and gettySpeed resources are passed to the /etc/getty process to indicate the 
desired device for the login sequence. The default value for each is "console." Another 
typical value for gettyLine is ite[0-3]. See getty{\M) for details. 
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grabServer (See grabTimeout.) 

grabTimeout 

To eliminate obvious security^ shortcomings in the X protocol, vuelogln grabs the server 
and keyboard while reading the name and password. The grabServer resource specifies if 
the server should be held while the name and password is read. When FALSE, the server 
is ungrabbed after the keyboard grab succeeds; otherwise, the server is grabbed until just 
before the session begins. The grabTimeout resource specifies the maximum time vuelo- 
gin will wait for the grab to succeed. The grab may fail if some other client has the server 
grabbed, or possibly if the network latencies are very high. The grabTimeout resource 
has a default of 3 seconds; be cautious when using this resource, since a user can be 
deceived by a look-alike window on the display. If the grab fails, vuelogin kills and res- 
tarts the server (if possible) and session. 

language 

This resource specifies the default setting for the LANG environment variable. If the 
vuelogin screen is localized for that language, it is displayed appropriately; otherwise, it is 
displayed in the language "C". The user may temporarily override this setting via an 
option on the login screen. When the subsequent session terminates, the LANG variable 
reverts to this setting. 

openDelay (See startAttempts.) 

openRepeat (See startAttempts.) 

operTimeout (See startAttempts.) 

pinglnterval (See pin^meout.) 

pin^imeout 

To discover when remote displays disappear, vuelogin occasionally "pings" them, using an 
X connection and sending XSync requests, pinglnterval specifies the time (in minutes) 
between successive ping attempts, and pingfTimeout specifies the maximum wait time (in 
minutes) for the terminal to respond to the request. If the terminal does not respond, the 
session is terminated. Vueloffn does not ping local displays. Although it may seem harm- 
less, it is undesirable when the workstation session is terminated as a result of the server 
hanging for NFS service and not responding to the ping. 

reset This specifies a program that is run (as root) after the session terminates. By default no 
program is run. The conventional name is Xreset. See The Xreset File below. 

resetForAuth 

The original implementation of authorization in the sample server reread the authoriza- 
tion file at server reset time, instead of when checking the initial connection. Since vweto- 
gtn generates the authorization information just before connecting to the display, an old 
server does not get current authorization information. This resource causes vuelogin to 
send SIGHUP to the server after setting up the file, causing an additional server reset to 
occur, during which time the new authorization information is read. 

resetSignal 

This resource specifies the signal to be sent to vuelogin to cause it to reread the 
configuration file and the file specified by the servers resource. 

resources 

This resource specifies the name of the file to be loaded by xrdb (i) as the resource data- 
base onto the root window of screen of the display. This resource data base is loaded 
just before the authentication procedure is started, so it can control the appearance of the 
"login" window. See the section below on the authentication screen, which describes the 
various resources that are appropriate to place in this file. There is no default value for 
this resource, but the conventional name is /usr/lib/Xll/vue/Vuelo^n/Xresources. 

session This specifies the session to be executed (not running as root). By default, 
/usr/bin/Xll /xtetm is run. The conventional name is Xsession. See The Xsession File 
below. 
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startAttempts 

Four numeric resources control the behavior of vuelogln when attempting to open reluc- 
tant servers: openDelay, openRqieat, opei^Timeout, and startAttempts. openDelay is the 
duration (in seconds) between successive attempts; openRepeat is the number of attempts 
to make; operiTimeout is the amount of time to wait while actually attempting the opening 
(i.e., the maximum time spent in the connect (2) syscall); and staitAttonpts is the number 
of times the entire process occurs before giving up on the server. After openRepeat 
attempts have been made, or if opeitTimeout seconds elapse in any particular attempt, 
vueloff,n terminates and restarts the server, attempting to connect again. This process is 
repeated stailAttanpts time, at which point the display is declared dead and disabled. 
(See OpenDelay, openRepeat, and opei^Timeout.) 

startup This specifies a program that is run (as root) after the authentication process succeeds. 
By default, no program is run. The conventional name for a file used here is Xstartup. 
See the Xstartup section below. 

systmnPath 

Vueloffn sets the PATH environment variable for the startup and reset scripts to the value 
of this resource. Note the conspicuous absence of "." from this entry. This is a good prac- 
tice to follow for root; it avoids many system penetration schemes. 

systemShell 

Vuelogtn sets the SHELL environment variable for the startup and reset scripts to the 
value of this resource. 

terminateServer 

This boolean resource specifies whether the X server should be terminated when a ses- 
sion terminates (instead of resetting it). This option can be used when the server tends to 
grow without bound over time in order to limit the amount of time the server is run. 

termSignal 

This resource specifies the signal to be sent to vuelogin to cause it to terminate all ses- 
sions and exit. 

userAuthDir 

When vuelogin cannot write to the usual user authorization file ($HOME/.Xauthority), it 
creates a unique file name in this directory and points the environment variable XAU- 
THORTTY at the created file. 

userPath 

Vuelogin sets the PATH environment variable for the session to this value. It should be a 
colon-separated list of directories; see sh(t) for a full description. 

xrdb Specifies the program used to load the resources. 

AUTHENTICATION SCREEN RESOURCES 

The authentication screen reads a name-password pair from the keyboard. As this is a Motif 
toolkit client, colors, fonts and some layout options can be controlled with resources. Resources 
for this screen should be put into the file named by the resources resource. 

The default logo on the authentication screen may be replaced with a bitmap of the user's choice. 
The following resources are available in addition to the standard Motif set in order to control 
positioning of the logo and the drop shadow. The resources should be prefaced with the string 
Vuelogin*logo* when specified. 

Logo Resource Set 

Name Class Type Default 

bitmapFile BitmapFile String NULL 
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dropShadowBackground 

dropShadowForeground 

dropShadowBackgroundPixtnap 

dropShadowThickness 

verticalOfFset 



DropShadowBackground Pixel Black 

DropShadowForeground Pixel White 

DropShadowBackgroundPixmap String 2S_foreground 

DropShadowThickness Int 400 

VerticalOffset Int 20 

X Position -1 

X Position -1 



bitmapFile 

Specifies the absolute path name to the bitmap file to be used for the logo. 

dropShadowBackground 

Specifes the background color for the drop shadow. 

dropShadowFor^round 

Specifes the foreground color for the drop shadow. 

dropShadowBackgroundPixmap 

Specifes the pixmap to be used for the drop shadow. This can either be a built-in Motif 
pixmap or the absolute path name to a bitmap to be used as the tile for the drop shadow. 

dropShadowThickness 

Specifes the thickness of the drop shadow in units of 100th_millimeters. 

verticalOffset 

Specifes the percentage of the logo to be positioned vertically off the main matte. By 
default the logo is centered horizontally and positioned vertically by this amount above 
the matte. This resource is ignored if y is specified. 

X Specifes the x origin for the logo in units of 100th_millimeters. This resource overrides 

the default horizontal centering of the logo. 

y Specifes the y origin for the logo in units of 100th_millimeters. This resource overrides 

the default vertical positioning of the logo. 



SESSION SIARTUP 

Three files are provided to assist in session startup. They can be replaced by other mechanisms 
via vueloffti resources. 

The Xstartup File 

This file is typically a shell script. It is run as "root" and should be very careful about security. 
This is the place to put commands that mount users' home directories from file servers, display 
the message of the day, or do other system-level functions on behalf of the user. Various environ- 
ment variables are set for the use of this script: 



DISPLAY 

HOME 

PATH 

USER 

SHELL 



is set to the associated display name 

is set to the home directory of the user 

is set to the value of the systemPath resource 

is set to the user name 

is set to the value of the systemShell resource 



No arguments of any kind are passed to the script Vuelogln waits until this script exits before 
starting the user session. If the exit value of this script is non-zero, vueloffn discontinues the ses- 
sion immediately and starts another authentication cycle. 

The Xsession File 

This script reads in the user's personal environment from SWOME/.vueprofile and then invokes 
the desired session manager. It is run with the permissions of the authorized user, and has several 
environment variables pre-set. See the ENVIRONMENT section for a list of the pre-set variables. 

The Xreset File 
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Symmetrical with Xstcatup, this script is run after the user session has terminated. Run as root, it 
should probably contain commands that undo the effects of commands in Xstattup, such as 
unmounting directories from file servers. The collection of environment variables that were 
passed to Xstartup are also given to J^set. 

TYPICAL USAGE 

Vueloffn is designed to operate in a wide variety of environments. The following setup is a good 
place to start, but may not be "typical" in many environments. 

First off, the vuelogtn configuration file should be set up. A good thing to do is to make a direc- 
tory (ex. /usr/lib/Xll/vue/Vueloff.n) that contains all of the relevant files. Here is a typical 
configuration file, which could be named Xconfig : 

Vuelogin.servers: /usr/lib/Xll/vue/Vuelogin/Xservers 

VueIogin.errorLogFile: /usr/lib/Xll/vue/Vuelogin/Xerrors 

Vuelogin.pidFile: /usr/lib/Xll/vue/Vuelogin/Xpid 

Vuelogin*resources: /usr/lib/Xll/vue/Vuelogin/Xresources 

Vuelogin*session: /usr/lib/Xll/vue/Vuelogin/Xsession 

As you can see, this file simply contains references to other files. Note that some of the resources 
are specified with "*" separating the components. These resources can be made unique for each 
different display, by replacing the "*" with the display-name. See RESOURCES earlier for a com- 
plete discussion. 

The first file /usr/lib/Xll/vue/Vuelogin/Xseivers contains the list of displays to manage. Most 
workstations have only one display, numbered 0, so the file looks like this: 

:0 Local local /usr/bin/Xll/X :0 

This keeps /usr/bin/Xll/X running on this display and manage a continuous cycle of sessions. 

The file /usr/Ub/Xll/vue/Vuelo^n/Xenors contains error messages from vuelogin and anything 
output to stderr \>y Xstartup, Xsession orXreset. When you have trouble getting vueloffn working, 
check this file to see if vueloffn has any clues to the trouble. Xerrors can become quite large and 
should be trimmed periodically. 

The next configuration entry, /usr/lib/Xll/vue/Vuelogin/Xresources, is loaded onto the display as 
a resource database using xrdb (1). As the authentication screen reads this database before start- 
ing up, it usually contains parameters for that screen. 



SOME OTHER POSSIBILITIES 

You can also use vuelogin to run a single session at a time by specifying the server on the com- 
mand line: 

vuelogin -server ":0 HP-TVRX local /usr/bin/Xll/X :0" 

Or, you might have a file server and a collection of X terminals. The configuration for this could 
look identical to the sample above, except thcXservers file might look like: 

extoLO HP700X foreign 
exalfcO NCD-19 foreign 
explode:0 NCR-TOWERVIEW3000 foreign 

This directs vuelogin to manage sessions on all three of these terminals. See "Controlling Vuelo- 
gin" above for a description of using signals to enable and disable these terminals much like 
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init(lM). 

If you have an X terminal that supports the XDMCP protocol, an entry for that terminal in 
Xsetvers is not required. If you have a file server and all X terminals support XDMCP, then 
Xservers would contain no entries. 

Configurations may contain combinations of local servers, X terminals without XDMCP, and X 
terminals with XDCMP. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X(l) for a full statement of rights and permissions. 

AUTHOR 

Vuelo^n is based on the MIT client XDM, authored by Keith Packard. Additional modifications 
were developed by Hewlett Packard. 

ORIGIN 

Hewlett-Packard Company ITO. 

SEE ALSO 

coniiect(2), login(l), getty(lM), sh(l), stty(l), tset(l), X(l), xdm(l), xinit(lM), xrdb(l), and 
XDMCP. 
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NAME 

vuepad ■ The HP YUE Text Editor . 

SYNOPSIS 

vuepad [file ...] 

DESCRIPTION 

Vuepad is a text editor for use within the X Window System environment Vuepad allows the use 
of the mouse for moving the edit cursor and for selecting portions of text for editing operations. 
Vuepad also supports the VUE drag and drop, allowing the user to drag file icons from the VUE 
file manager onto the vuepad window for editing. 

OPTIONS 

The following option is available from the command line 

-session session file 

This option takes the name of a session file as an additional parameter. Vuepad is run 
with the specified session file name. The session file is a file that was previously saved by 
vuepad through a session shutdown. 

RESOURCES 

The following table and descriptions define resources used to specify data iot vuepad. 

Vuepad Resource Set 
Name Class T^pe Default 

session Session String NULL 

COPYRIGHT 

Copyright 1990 Hewlett-Packard Company. 

ORIGIN 

Hewlett-Packard Company ITO. 
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^fAME 

vuesession - The HP VUE Session Manager. 

SYNOPSIS 

vuesession [options] 

DESCRIPTION 

Vuesession provides session management functionality during an HP VUE session, the time from 
login to logout. It allows for saving a session, restoring a session, locking a session, and allocating 
colors for HP VUE compatible clients. 

When a session is saved, client information, server settings, and resources are retained. Qient 
information consists of all clients currently active in the session. Server settings consist of settings 
(such as the beeper or keyboard) that are modified by a call to the server. Resources consist of all 
resources currently stored on the RESOURCE_M\NAGER property on the root window of the 
default screen. 

The session is locked by pressing the lock" button on the workspace manager (&ont panel). 
When the display is locked, no further input is accepted until a correct password is entered. 
Correct passwords include the user who locked the display, the root password for the system, and 
any users specified in the keys resource. 

Color allocation provides each client with a set of colors which are used in creating visual com- 
ponents. These colors can then be dynamically changed by using the HP VUE S^e Manager 
(vuestyleQX)). 

Vuesession is automatically invoked by the HP VUE Lo^n Manager (yuelogm{lX)). If the HP 
VUE Login Manager is not currently being used, vuesession can be invoked by putting the follow- 
ing command in an .xsession or .xllstart file: 

/usr/lib/Xll/vue/etc/vuesession-norestore 

WARNING: This command must be the first Xll client in the file (other than xrdb). It must be 
run in the foreground. When using this command, no save and restore functionality is available. 
Any calls that start up window managers must be removed from the startup file. The default win- 
dow manager can only be changed by setting the wmStartupCommand resource. 

OPTIONS 

-norestore 

This option allows users to use vuesession in a limited way. The advantage of using this 
option is that vuesession can be started directly from an .xllstart or .xsession script. See 
use and warning above. 

CUSTOMIZATION 

Vuesession's behavior can be customized through the use of the HP VUE Stjie Manager's startup 
dialog. The following is the behavior that can be customized. 

HP VUE Session Manager Customization Options 
Name Default 

Display Logout Confirmation On 

Set Home Session N/A 

Startup Behavior Resume Current Session 

Display Logout Confirmation 

"Display Logout Confirmation" allows you to toggle the appearance of the logout 
confirmation box that appears after you click on the logout button located in the 
workspace manager, or choose the "Log out..." option available in the vuewm root menu. 
Setting the button displays the logout dialog. Qearing the button causes immediate exit 
with no confirmation. The default behavior is that the logout confirmation dialog will be 
displayed. 
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Set Home Session 

The "Set Home Session" button allows you to save a home session for use later. The 
home session is a "snapshot" session that you can return to by changing logout options. 

Startup Behavior 

The startup behavior allows you to specify v^ich state the HP VUE Session Manager 
will restore upon startup (login). The default is that it automatically restarts the state 
you were in at logout (Resume Current Session). The other states available are "Return 
to Home Session" and "Ask Me at Logout" "Return to Home Session" returns you to the 
last saved home session at next startup. "Ask Me at Logout" allows you to choose which 
behavior you would prefer at logout time. If "Return to Home Session" is chosen, a 
home session has to have been previously saved. Otherwise the de&ult system session 
will appear at next login. Note that "Ask Me at Logout" cannot be active while "Display 
Logout Confirmation" is turned off. 

RESOURCES 

Vuesession uses the following resources. 



Name 



HP VUE Session Manager Resource Set 



Class 



T^pe 



Default 



alarmTime 


AlarmTime 


unsigned int 


10 


colorUse 


ColorUse 


int 


dynamic* 


coverScreen 


CoverScreen 


Boolean 


False 


dynamicColor 


DynamicColor 


Boolean 


True 


foregroundColor 


ForegroundColor 


int 


dynamic* 


keys 


Keys 


unsigned char 


NULL 


queryServerSettings 


QueryServerSettings 


Boolean 


False 


shadowPixmaps 


ShadowPixmaps 


int 


dynamic* 


wmStartupCommand 


WmStartupCommand 


executable path 


NULL 


writeXrdbColors 


writeXrdbColors 


Boolean 


True 


*The display type determines default 







alarmTime 

This resource specifies (in seconds) the amount of time before the lock dialog is removed 
from the screen. When the display is locked, the pointer shows a lock cursor, and a dia- 
log appears which asks for the user password. If no activity from the pointer or keyboard 
is detected for alamirime seconds, the dialog is removed from the screen. The lock dia- 
log is redisplayed as soon as a pointer or keyboard event is detected. An alarmTime of 
leaves the lock dialog in place for the entire time the display is locked. The default value 
is 10 seconds. 



colorUse 



This resource specifies the number of colors to use for the user interface. Valid types are: 

• B W - Specifies a black and white system. The color palettes will use two color cells 
for the user interface. In this configuration only two color palettes are available: 
BlackWhite and WhiteBlack. These palettes cannot dynamically change. To change a 
palette, all applications using that color palette must be restarted. This resource value 
forces ShadowPixmaps to True, and ForegroundColor to either black or white 
depending on the palette chosen. 

• LOW_COLOR - Specifies a low color system. The color palettes will have two color 
sets and use a maximum of 12 color cells for the user interface, including black and 
white (color cells and 1). The number of color cells can be reduced by using the 
resources ShadowPixmaps and ForegroundColor. 

• MEi)IUM_COLOR - Specifies a medium color system. The color palettes will have 4 
color sets and use a maximum of 22 color cells for the user interface, including black 
and white (color cells and 1). The number of color cells can be reduced by using the 
resources ShadowPixmaps and ForegroundColor. 
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HIGH_COLOR - Specifies a high color system. The color palettes will have 8 color 
sets and use a maximum of 42 color cells for the user interface, including black and 
white (color cells and 1). The number of color cells can be reduced by using the 
resources ShadowPixmaps and For^roundColor. The default value for this resource 
will be determined by querying the X server for the number of color cells on the sys- 
tem. 



planes 


ColorUse 


2J 


B W 


4 


LOW COLOR 


6 


MEDIUM COLOR 


8+ 


HIGH COLOR 



coverScreen 

This resource specifies whether or not the screens of the display will be covered when the 
display is locked. The default value is False, ^ich means that the screens will not be 
covered. 

dynamicColor 

This resource can have values of True or False and is used to reduce the number of color 
cells being used. Once a palette has been selected and the user will not be changing 
palettes often, dynamicColor can be set to False. When the session comes up next time, 
the color server will use Read Only color cells that can be shared by non-Motifl.l clients, 
thus reducing total number of color cells used. The default value is True. 

foregroundColor 

This resource can have values of White, Black or Dynamic. ForegroundColor causes all 
text (foreground) to use either pixel or 1 (Black or White) or to have a color cell dedi- 
cated to foreground and changes in response to the background color (Dynamic) for each 
ColorSet. If set to White or Black, the number of color cells used per ColorSct is reduced 
byL 

k^s This resource is a list of "keyholders" who have the ability to unlock the screen any time it 
is locked by the user. The list is a list of user id's separated by commas. For example if 
user kimd has the following resource active during a session: 

'Vuesession*keys: fredh,keith 

Users fredh and keith have the ability to unlock the display when kimd locks it. 

queryServerSettings 

This resource specifies whether vuesession queries the server at logout for all its settings 
or saves only those settings set by using the HP VUE Stjde Manager. Querying the server 
ensures that all settings are saved; however, there is a degradation in performance when a 
full query is done. The default value is False, which means that the server will not be 
queried. 

shadowPbanaps 

For color systems, this resource can have a value of True or False. If True, topSha- 
dowCoIor and bottomShadowColor use the same pixel as background and topShadowPix- 
map and bottomShadowPixmap are specified instead of solid color to create the 3D look. 
This reduces the number of color cells per ColorSet by 2. ShadowPixmaps defaults to 
True for systems with 4 or less color planes (16 or less color cells), and False for systems 
with more than 4 color planes. 

wmStartupCommand 

TTiis resource allows for an alternate window manager to be started at login. If this 
display is NULL, vuesession starts /usr/bin/Xll/vuewm. An alternate startup might 
look like: 

'Vuesession*wmStartupCommand: /usr/bin/Xll/mwm 
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Note that the command should not have any commands to a shell in it, and that it should 
not be surrounded by quotes. Also, if any other window manager other than vuewm is 
used, clients will be restored, but may not be restored to the correct position. By default, 
this resource contains a NULL value. 

writeXrdbColors 

This resource should only be used if you are running non HP Motif 1.1 clients that have 
color schemes that conflict with HP VUE colors. This has no impact on clients linked 
with the Motif 1.1 library. This resource specifies i^ether color resource information 
should be written out If set to False, background and foreground resources will not be 
written out with the values of the current palette. This means that non HP Motif 1.1 
clients will not get HP VUE colors when they are started. The default value is True. 

COPYRIGHT 

Copyright 1990 Hewlett-Packard Company. 

ORIGIN 

Hewlett-Packard ComanylTO. 

RELATED INFORMATION 

X(l), vuestyle(lX), vuewm(lX), vuelogin(lX). 
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NAME 



vuestyle • The HP VUE Style Manager. 



SYNOPSIS 

vuestyle 

DESCRIPTION 

Vuestyle is the HP VUE S^e Manager application that provides an interactive method of custom- 
izing sessions and workspaces. Vuestyle starts the St^e Manager window from which push buttons 
open dialog boxes for the following: 

Audio Change the beeper's volume, tone, and duration. Setting tlite volume to zero turns 

the beeper oS. The beeper sounds when the mouse button is released after moving 
any of the sliders. 

Backdrop Choose from a list of backdrop bitmaps to change workspace background patterns. 
Distinguish workspaces by using a unique backdrop for each. 

Color Choose from a list of color palettes to change workspace colors. Colois dynamically 

update on the display when a different palette is chosen. The display Qpe (mono- 
chrome, low-, medium-, or high-color) determines the number of colors available. 

Fonts Change font size to small, medium, or large. The display type, in part, determines 

the exact font sizes. For example, a large font size on a high-resolution display may 
look difiEerent from a large font size on a medium-resolution display. Font size 
changes are not dynamic. New font sizes are used the next time an HP VUE session 
starts (logout, then login) with "Resume current session" set in the Session Startup 
dialog box. New font sizes can also be used by clients started after a new font size 
selection if the resource Vuestyle*writeXrdbInimediate is set to True. 

Hosts Add or remove hosts (other computers on your network) to or fix>m a list that allows 

them to show information on your display. Enable or disable security with the toggle 
button. 

Mouse Reverse mouse button order, change mouse pointer speed, or change double-click 

speed. A mouse picture shows a two- or a three-button mouse with the buttons num- 
bered. The mouse pictured depends on the type of mouse attached to the computer. 
A toggle button reverses button order. 

"Acceleration" and Threshold" sliders define how fast the pointer moves when the 
mouse is moved. Changes are dynamic (except for double click) and take place after 
the slider is released. The "Double-Qick" slider defines the time between the flrst 
and second click in a double-click action. The range is .1 to 1.0 seconds. The mouse 
picture is a button to test double-click response. New double-click speed is used the 
next time your HP VUE session starts (logout, then login) with "Resume current ses- 
sion" set in the Session Startup dialog box. New double-click speed can also be used 
by clients started after a new double-click selection if the resource 
'N^estyle*writeXrdbImmediate is set to True. 

Keyboard Set key click volume or character auto repeat. The "Qick Volume" slider ranges from 
zero (oflE) to 100 percent There is also an auto-repeat toggle button. The selected 
actions take place immediately to allow testing while the dialog box is still open. 

Screen Prevent bright colors from burning into your display by using screen-saver. Turn 

screen saver on or off and specify time out intervals. A Time Out" slider ranges from 
zero (off) to 120 minutes. Toggle the "Logo" button to either display an X logo or a 
blank screen during a time out. 

Startup Specify how your next HP VUE session starts. Radio buttons offer choices to resume 
the current session, to restore the home session, or to query on exit. Select "Display 
logout confirmation dialog box" to confirm at logout that you really want to log out. If 
unselected, immediate logout occurs without the dialog box query. The "Set Home 
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Session" push button opens an information dialog box to confirm the home session 
change. 

RESOURCES 

The following tables and descriptions define resources used to specify data for vuestyle. 

Backdrop Resource Set 

Name Class T^ype Default 

backdropDirectory BackdropDirectory string /usr/lib/Xll/bitmaps/Vuebackdrops 

backdropDirectory 

Specifies the directory location for the bitmaps listed in the backdrop dialog box. 



Color Resource Set: Global (applies to all clients) 
Name Class Type Default 



colorUse 

dynamicColor 

foregroundColor 

paletteDirectories 

shadowPixmaps 

writeXrdbColors 


ColorUse 

DynamicColor 

ForegroundColor 

PaletteDirectories 

ShadowPixmaps 

WriteXrdbColors 


int 

Boolean 

int 

string 

int 

Boolean 


dynamic* 

true 

dynamic* 

NULL 

dynamic* 

true 



*The display type determines default. 

colorUse 

Specifies the number of colors to use for the user interface. Valid types are: 

• B_W - Specifies a black and white system. The color palettes will use two color cells 
for the user interface. In this configuration only two color palettes are available: 
BlackWhite and WhiteBlack. These palettes cannot dynamically change. To change a 
palette, all applications using that color palette must be restarted. This resource value 
forces ShadowPixmaps to True, and ForegroundColor to either black or white 
depending on the palette chosen. 

• LOW_COLOR - Specifies a low color system. The color palettes will have two color 
sets and use a maximum of 12 color cells for the user interface, including black and 
white (color cells and 1). The number of color cells can be reduced by using the 
resources ShadowPixmaps and ForegroundColor. 

• MEDIUM COLOR - Specifies a medium color system. The color palettes will have 4 
color sets and use a maximum of 22 color cells for the user interface, including black 
and white (color cells and 1). The number of color cells can be reduced by using the 
resources ShadowPixmaps and ForegroundColor. 

• HIGH COLOR - Specifies a high color system. The color palettes will have 8 color 
sets and use a maximum of 42 color cells for the user interface, including black and 
white (color cells and 1). The number of color cells can be reduced by using the 
resources ShadowPixmaps and ForegroundColor. The default value for this resource 
will be determined by querying the X server for the number of color cells on the sys- 
tem. 

planes ColorUse 



2-3 1^ B W 
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4 
6 

8+ 



LOWCOLOR 

MEDIUM COLOR 

HIGH COLOR 



dynamicColor 

This resource can have values of True or False. DynamicColor is used to reduce the 
number of color cells being used. Once a palette has been selected and the user will not 
be changing palettes often, DynamicColor can be set to False. When the session comes 
up next time, the color server will use Read Only color cells that can be shared by non- 
Motifl.l clients, thus reducing total number of color cells used. 

foregroundColor 

This resource can have values of White, Black or Dynamic. ForegroundColor causes all 
text (foreground) to use either pixel or 1 (Black or White) or to have a color cell dedi- 
cated to foreground and changes in response to the background color (Dynamic) for each 
ColorSet. If set to White or Black, the number of color cells used per CoIorSet is reduced 
byl. 

paletteDirectories 

This resource specifies the directories where color palettes may be located. These palette 
files are used to generate the list of color palettes that a user may select from for color 
generation. 

shadowPixmaps 

For color systems, this resource can have a value of True or False. If True, topSha- 
dowCoIor and bottomShadowCoIor use the same pixel as background and topShadowPix- 
map and bottomShadowPixmap are specified instead of solid color to create the 3D look. 
This reduces the number of color cells per ColorSet by 2. ShadowPixmaps defaults to 
True for systems with 4 or less color planes (16 or less color cells), and False for systems 
with more than 4 color planes. 

writeXrdbCoIors 

This resource should only be used if you are running non HP Motif 1.1 clients that have 
color schemes that conflict with HP VUE colors. This has no impact on clients linked 
with the Motif 1.1 library. This resource specifies whether color resource information 
should be written out. If set to False, bacl^ound and for^round resources will not be 
written out with the values of the current palette. This means that non HP Motif 1.1 
clients will not get HP VUE colors when they are started. The default value is True. 

Color Resource Set: Client Specific (specified on a per client basis) 
Name Class Type Default 

primaiyColorSetld PrimaryColorSetId lint 3 

secondaryColorSetId SecondaryColorSetId int 4 

primaryColorSetId 

This resource specifies the primary color for an application. The primary color is used 
for the main background areas of the application and all children of the main area. The 
value of this resource is a number from one to eight that represents a specific color set in 
a palette. 

secondaryColorSetId 

This resource specifies the secondary color for an application. The secondary color is 
used for the menubar and all menus and dialogs of the application. This allows dialogs 
on the screen to be visually associated with its parent application by matching the dialog 
color to the menubar. The value of this resource is a number fk)m one to eight that 
represents a specific color set in a palette. 
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Color Resource Set: Workspace Manager 
Name Class Typ« Default 



activeColorSetId 
inactiveColorSetId 



ActiveColorSetId 
InactiveColorSetId 



int 
int 



activeColorSetId 

Specifies the active frame color for vuewm. The value of this resource is a number from 
one to eight, that represents a specific color set in a palette. 

inactiveColorSetId 

Specifies the inactive frame color for vuewm. The value of this resource is a number from 
one to eight that represents a specific color set in a palette. 



Name 



Fonts Resource Set 
Class Type Default 



largeUserFontHR 


FontList 


XmFontList 


largeUserFontMR 


FontList 


XmFontList 


largeSysFontHR 


FontList 


XmFontList 


largeSysFontMR 


FontList 


XmFontList 


mediumUserFontHR 


FontList 


XmFontList 


mediumUserFontMR 


FontList 


XmFontList 


mediumSysFontHR 


FontList 


XmFontList 


mediumSysFontMR 


FontList 


XmFontList 


smallUserFontHR 


FontList 


XmFontList 


smallUserFontMR 


FontList 


XmFontList 


smallSysFontHR 


FontList 


XmFontList 


smallSysFontMR 


FontList 


XmFontList 



-*-prestige-medium-r-normal-*-160-72-* 

-•-prestige-medium-r-normal-*-128-* 

-*-swiss*742-medium-r-normal-*-140-*-p-110-* 

-•-swiss*742-bold-r-normal-*-140-«-p-100-* 

-•-prestige-medium-r-normal*-128-* 

-•-prestige-medium-r-normal*-120-* 

-•-swiss*742-bold-r-normal-*-140-*-p-100-' 

-*-swiss*742-bold-r-normal-*-120-* 

-*-prestige-medium-r-normal-*-120-* 

-*-courier-medium-r-*-120-* 

-*-swiss*742-boId-r-normal-«-120-* 

-•-helvetica-bold-r-normal-*-100-* 



largeUserFontHR 

Specifies the large font used for editable areas such as text edit fields and lists for high- 
resolution displays. 

lai^UserFontMR 

Specifies the large font used for editable areas such as text edit fields and lists for 
medium-resolution displays. 

largeSysFontHR 

Specifies the large font used for label areas such as window frames, menus, and push but- 
tons for high-resolution displays. 

largeSysFontMR 

Specifies the large font used for label areas such as window frames, menus, and push but- 
tons for medium-resolution displays. 

mediumUserFontHR 

Specifies the medium font used for editable areas such as text edit fields and lists for 
high-resolution displays. 

mediumUserFontMR 

Specifies the medium font used for editable areas such as text edit fields and lists for 
medium-resolution displays. 

mediumSysFontHR 

Specifies the medium font used for label areas such as window frames, menus, and push 
buttons for high-resolution displays. 

mediumSysFontMR 

Specifies the medium font used for label areas such as window frames, menus, and push 
buttons for medium-resolution displays. 
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smallUserFontHR 

Specifies the small font used for editable areas such as text edit fields and lists for high- 
resolution displays. 

smallUserFontMR 

Specifies the small font used for editable areas such as text edit fields and lists for 
medium-resolution displays. 

smallSysFontHR 

Specifies the small font used for label areas such as window frames, menus, and push but- 
tons for high-resolution displays. 

smallSysFontMR 

Specifies the small font used for label areas such as window frames, menus, and push but- 
tons for medium-resolution displays. 



Session Behavior Resource 
Name Class Type Default 

Vuestj1e*writeXrdbImmediate Vuest)ie*wTiteXrdbImmediate Boolean False 

VuestyIe*writeXrdbImmediate 

Controls when new font size or new mouse double-click time resources are used. If True, 
new resources are used when new clients start. If False, new resources are used at the 
next session (after logout, with "Resume Current Session" selected in the session startup 
dialog box, and login). 

COPYRIGHT 

Copyright 1990 Hewlett-Packard Company. 

ORIGIN 

Hewlett-Packard Company ITO. 
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NAME 

vuewm - The HP VUE Workspace Manager. 

SYNOPSIS 

vuewm [options] 

DESCRIPTION 

Vuewm is an Xll window manager based upon the Motif Window Manager (mwm, version 1.1). 
Vuewm is an integral part of the Hewlett-Packard Visual User Environment (HP VUE). It com- 
municates with and facilitates access to the other components in the environment. 

Access to many other VUE components is provided throughout the flvnt panel (workspace 
manager). The front panel can be configured to contain controls and indicators for tasks that you 
perform frequently. These controls include file management, session management, customization, 
printing, trash, help, or other functions that maybe user defined. 

Workspace window management represents a significant enhancement of mwm. Workspaces can 
be thought of as virtual screens. Multiple workspaces gives you a larger, virtual screen area to 
place your windows on. 

Vuewm provides the same window management and limited session management functionality as 
mwm. It gives you (the user or programmer) the ability to control window size, position, state 
(iconic or normal), input focus ownership, etc. It also provides session management functions such 
as stopping a client. 



OPTIONS 

-display display 

TTiis option specifies the display to use, typically of the form 
hostname:dispIay number.screen_number. For example, -display oregon:2.0 specifies the 
first screen of the second display of host Oregon. 

If no screenjiumber is specified, the first screen (screen "0") becomes the default, or 
VUE screen, of the display. The front panel is available on the VUE screen. See also 
Xil). 

-xrm resourcestring 

This option specifies a resource string to use. For example, vuewm -xrm 
"vuewm'SvorkspaceList: A B C D" specifies the resource names (and indirectiy, the 
number) of workspaces that vuewm should create at runtime. 

For example, vuewm -xnu "vuewm^keyboardFocusPolicy: pointer" specifies that vuewm 
should automatically set the input focus to the window under the pointer. 

You can specify multiple resources by adding one -xrm option after another. 

-multiscreen 

This option causes vuewm to manage all the screens on the display. By default, vuewm 
manages only the default screen of the display. For example, vuewm -display locakO.! 
-multiscreen instructs vuewm to manage all the screens on display and to place the 
front panel on the second screen (i.e., screen "1"). 

•screens name [name...] 

This option specifies the screens names to use for fetching screen-based resources. If 
-multiscreen is not specified, then the only the first name of the list of names will be 
used. If -multiscreen is specified, all the names will be used up to the number of screens 
managed. The first screen on the display (screen 0) will use the first name, the second 
screen will use the second name, and so on. If there are more screens to manage than 
names in the list, the first name on the list will be reused for the remaining screens. 
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If no names are specified, vuewm constructs the screen name(s) dynamically, based on 
two screen characteristics: 

Sk:reen Resolution The screen resolution may be HigfiRes (typically, 1280 by 1024 pi}»ls), 

MedRes (typically, 1024 by 768 pixels), or LowRes (fewer pixels). 

Screen Color T^ype The screen color type maybe Mono (2-4 colors), LowColor (16 colors), 

MedColor (64 colors), otHi^Color (256 colors). 

For example, at run-time vuewm constructs the screen name HigfiResHighColor for an 8-plane 
(2''8, or 256-color) 1280x1024 HP 98550A display subsystem. 

The screen name is important because it controls the number and names of your workspaces, your 
color schemes and backgrounds, your menus, your key and button bindings, and the icon box 
operations on a per screen basis. 

The /usr/Iib/Xll/app-defauIts/Vuewm application defaults file shipped with vuewm includes rea- 
sonable screen settings for most screen resolution and color types. 

STARTUP 

Normally, the session manager (vuesession) starts vuewm by running the executable as 
/usr/bin/Xll /vuewm. You can change this invocation by modifying a vuesession resource, 
wmStartupCommand. 

For example, the following line from the /usr/lib/Xll/app-defaults/Viiesession file causes vuewm 
to manage all the screens on the display: 

Vuesession*wmStartupCommand: /usr/bin/Xll/vuewm -multiscreen 

(By default, vuewm manages only one screen.) Using command line options is one way of control- 
ling the behavior of vuewm. Using resources is another. 

APPEARANCE 

The following sections describe the basic default behaviors of windows, icons, the icon box, input 
focus, and window stacking. The appearance and behavior of the window manager can be altered 
by changing the configuration of specific resources. Resources are defined under the heading "X 
DEFAULTS." 

WINDOWS 

Default vuewm window frames have distinct components with associated functions: 

Title Area In addition to displaying the client's title, the title area is used to move 

the window. To move the window, place the pointer over the title area, 
press button 1 and drag the window to a new location. A wire frame is 
moved during the drag to indicate the new location. When the button 
is released, the window is moved to the new location. 

Title Bar The title bar includes the title area, the minimize button, the maximize 

button and the window menu button. 

Minimize Button To turn the window back into its icon, do a button 1 click on the minim- 

ize button (the frame box with a small square in it). 

Maximize Button To make the window fill the screen (or enlarge to the largest size 

allowed by the configuration files), do a button 1 click on the maximize 
button (the frame box with a large square in it). 

Window Menu Button The window menu button is the frame box with a horizontal bar in it 
To pop up the window menu, press button 1. While pressing, drag the 
pointer on the menu to your selection, then release the button when 
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your selection is highlighted. Alternately, you can click button 1 to pop 
up the menu and keep it posted; then position the pointer and select 



Default Window Menu 



SekctkM 


Accelerator 


Dcccripdon 


Restore 


Alt+F5 


Inactive (not an option for windows). 


Move 


Alt+F7 

Shift + MoweGroPW 


Allows the window to be mewed with keys 
or mouse. 

^)oUo keyboard. 


Size 


Alt+F8 
MoweGranr 


Allows the window to t>e resized. 
.^x>Uo keyboard. 


Minimize 


AU+F9 
Shift + Pop 


'I\ims the window into an icon. 
Apcdloki^board. 




Alt+FlO 

Qrl + Move Grow 


Makes the window fill the screen. 
Apollo keytxMutl. 




Alt+F3 


Maws window to twttom of window 
stack. 


Occqy... 


Alt+O 


Display the WoikqMce Presence dialog to 
control the presence of the client in 
woikspaces. 


OccnyAll 


Alt+Shift+O 


Put the client in all woikspaces. 


Remove from WS 


Alt+Shift+F4 


Remove the client from the current 
woikspace. (Inactive if the client is in ody 
one workspace.) 



Qose 



Removes client from vuewm management. 



Resize Border Handles 



To change the size of a window, move the pointer over a resize border 
handle (the cursor will change), press button 1, and drag the window to 
a new size. When the button is released, the window is resized. While 
dragging is being done, a rubber-band outline is displayed to indicate 
the new window size. 



Matte 



An optional matte decoration can be added between the client area and 
the window frame. A matte is not actually part of the window ftame. 
There is no functionality associated with a matte. 



ICONS 



Icons are small graphic representations of windows. A window can be minimized (iconified) using 
the minimize button on the window frame. Icons provide a way to reduce clutter on the screen. 

Pressing mouse button 1 when the pointer is over an icon will cause the icon's window menu to 
pop up. Releasing the button (press + release without moving mouse = click) will cause the 
menu to stay posted. The menu contains the following selections: 
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Icon Window Menu 



Selection 


Accelerator 


Description 


Restore 


Alt+F5 
Shifi+Pop 


Opens the associated window. 
.^x>Uo keyboard. 


Move 


Alt+F7 

Shift + Move Grow 


Iteys. 

Apollo Iceyboard. 


Size 


Alt+F8 


Inactive (not an option for icons). 


Mimmize 


Alt+F9 


Inactive (not an option for icons). 




Ait+no 

Qrl + Pop 


Opens the associated window and 
makes it fill the screen. 

.^mllo keytxxuxL 


I-ower 


Alt+F3 


Mcwes icon to bottom of icon 
stack. 


Ocaspf... 


Alt+O 


Displ^ the >M»kspace Presence 
dialog to control the presence of 
the client inworicspaoes. 


OcCT^yAll 


Alt+Shift+O 


Put the dient in all workspaces. 


Remove &om WS 


Alt+Shift+F4 


Remove the client flxan the current 
woikspace. (Inactive if the client is 
in onfy one wortcspace.) 



Qose Alt+F4 Remcves client from vuewm 

management. 

Double-clicking button 1 on an icon normalizes the icon into its associated window. £)ouble- 
clicking button 1 on the icon box's icon opens the icon box and allow access to the contained icons. 
(In general, double-clicking a mouse button offers a quick way to have a function performed. 
Another example is double-clicking button 1 with the pointer on the window menu button. This 
closes the window.) 

ICON BOX 

When icons begin to clutter the screen, they can be packed into an "icon box." (To use an icon 
box, vuewm must be started with the icon box configuration already set.) The icon box is a window 
manager window that holds client icons. There is one icon box for each workspace. Icons in the 
icon box can be manipulated with the mouse. The following table summarizes the behavior of this 
interface. Button actions apply whenever the pointer is on any part of the icon. 



Button Action 


Description 


Button 1 cUck 


Selects the icon. 


Button 1 double cUck 


Normalizes (opens) the associated window. 


Button 1 donble cUck 


Raises an already open window 
tothetopoftbestadc 



Button 1 drag 



McK«s the icon. 



The window menu of the icon box differs from the window menu of a client window: The "Qose" 
selection is replaced with the Tacklcons Alt + Shift + FT" selection. When selected, Packlcons packs 
the icons in the box to achieve neat rows with no empty slots. 

If the front panel is used with the icon box in vuewm, the behavior of the icon box can be changed. 
If the vuewmbox control is in the front panel, closing the icon box will cause it to disappear from 
the workspace. Pressing on the vueiimbox control will cause the icon box to reappear if it is 
closed, or to be raised if it is open. In this way, the icon box is made to appear like other clients 
that are connected to controls in the front panel. (See the /usr/lib/Xll/vue/Vuewm/sys.vuewmrc 
file for more information). 
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INPUT FOCUS 

Vuewm supports (by default) a keyboard input focus policy of eiqplicit selection. This means when 
a window is selected to get keyboard input, it continues to get keyboard input until the window is 
withdrawn from window management, another window is explicitly selected to get keyboard input, 
or the window is iconified. There are numerous resources that control the input focus. The client 
window with the keyboard input focus has the active window appearance with a visually distinctive 
window frame. 

The following tables summarize the keyboard input focus selection behavior 



Button Action 



Object 



Function Description 



Button 1 press Window / window frame Keyboard focus selection 



Button 1 press 



Icon 



Keyboard focus selecti<m 



Key Action 



[Alt](Tab] 
[NextVi^Klw] 



Function Description 



Mcwe iiq>ut focus to next window in windcmr stadc 
Apollo keyboard. 



[Alt][Shift][Tab] Move ii^ut focus to previous window in window stack. 

[Sbift][Next Wndw] Apollo keyboard. 



WINDOW STACKING 

The stacking order of windows may be changed as a result of setting the keyboard input focus, 
iconifying a window, or by doing a window manager window stacking function. 

When a window is iconified, the window's icon is placed on the bottom of the stack. 

The following table summarizes the default window stacking behavior of the window manager 



Key Action 



Function Description 



[Alt]IESq 
[Qrl][Pop] 



Put bottom window on top of stadc 
Apollo keyboard. 



[Alt][Shift][ESC] Put top window on bottom of stack. 
[Alt][Pop] Apollo keyboard. 



[Pop] 



Apollo keytxiard. Put bottom window on top 
of stadc; put top window on bottom of stack. 



A window can also be raised to the top when it gets the keyboard input focus (e.g., by doing a but- 
ton 1 press on the window or by using [AltJfTab]) if this auto-raise feature is enabled with the 
focusAutoRaise resource. 

FRONT PANEL 

The front panel is a central feature of the VUE environent. In it are controls that connect you with 
useful system functions and other VUE components. The de&ult VUE environment comes with 
the pre-configured front panel described below. 

In the center of the front panel is the workspace switch which you use to switch between 
workspaces. The top row of the front panel also includes a clock, today's date, mail, system load, 
printer, file management, application management, and trash. The bottom row of the front panel 
provides access to terminal windows, system customization, workspace renaming, screen locking, 
help, and session termination. 

A control in the front panel is typically one of four types: 

INDICATOR An indicator monitors the state of a file, typically your incoming mail- 

box, and changes its image based on whether the file has changed. 

PUSH BUTTON A push button starts an action each time it is pushed. For example, 

each time you depress the terminal button, a new hpterm window will 
appear. 
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TCKJGLE BUTTON A toggle button is tied to one instance of a client. If a client is not run- 

ning, pressing the toggle button will start the client If a client is run- 
ning, pressing the toggle button will bring the client into the current 
workspace, make sure the client is in the normal (not iconic) state, and 
raise it to the top of the window stack. 

VUEWM BUTTON A vuewm button has specialized behavior defined within vuewm. 

Examples include the clock and calendar readouts, the icon box button, 
and the workspace switch. 

The front panel can be configured for custom installations. (See the 
/usr/lib/Xll/vue/Vuewm/sys.vuewmrc file for more information). 

WORKSPACES 

Vuewm will create as many workspaces as are defined in the workspaceList resource. Workspaces 
may be renamed dynamically from the Workspace Manager dialog. This dialog can be called up 
either from a button on the front panel or by activating a button binding or key binding that you 
have defined (see Cworkspace rename). 

Switching between workspaces is normally done by clicking on the workspace switch, \^ich is usu- 
ally located centrally in the fix>nt panel. Workspace switching can also be accomplish via key and 
button bindings (see flnext_workspace and tprev_workspace). 

Windows may inhabit one or many workspaces. This can be controlled on a per-window basis by 
calling up the Workspace Presence dialog. This dialog is normally posted from the window menu, 
but may also be posted with a button or key binding (see £workspace_pres«nce). This dialog lets 
you select the workspaces you want the window to be in from a list of available workspaces. It is 
also useful to see what workspaces a window is currently in. 

DYNAMIC CUSTOMIZATION 

When vuewm is running as part of HP VUE, you have access to dynamic customization of some 
aspect of vuewm through vuestyle. Vuestjie is started by pressing the vues^e button (the artist's 
palette) on the fix)nt panel. Color and backdrops can be customized dynamically. Font changes 
will not take effect until the next session or until vuewm is restarted. 

NOTE: 

The dynamic customization of colors operates on a fixed set of color resources allocated 
specifically for HP VUE. You will not be able to dynamically customize the colors of components 
for which you have set color resources explicitly (see X DEFAULTS). 

X DEFAULTS 

Vuewm is configured from its resource database. This database is built from the following 
sources. They are listed in order of precedence, low to high: 

app-defaults/Vuewm 

RESOURCEMANAGER root window property or $HOME/.Xdefaults 

XENVIRONMENT variable or $HOME/.Xdefaults-host 

vuewm •xnu and -screens command line options 

Entries in the resource database may refer to other resource files for specific types of resources. 
These include files that contain bitmaps, fonts, and vuewm specific resources such as menus and 
behavior specifications (i.e., button and key bindings). 

Viiewm is the resource class name of vuewm and vuewm is the resource name used by vuewm to 
look up resources. In the following discussion of resource specification 'Vuewm" and "Vuewm" can 
be used interchangeably. However, if conflicting resources are specified, resources specified by 
resrouce name ("vuewm") will take precedence over resource specified by resource class 
("Vuewm"). 

Vuewm uses the following types of resources: 
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Component Appearance Resources: 

These resources specify appearance attributes of window manager user interface components. 
They can be applied to the appearance of window manager menus, feedback windows (e.g., the 
window reconfiguration feedback window), client window frames, and icons. Generally, these 
resources are specified on a per-screen basis (the same for all workspaces in a screen). 

Specific Appearance and Behavior Resources: 

These resources specify vuewm appearance and behavior (e.g., window management policies). 
They are not set separately for different vuewm user interface components. Some of these 
resoures are global in scope; others maybe specified on a per-screen basis. 

Oient Specific Resources: 

These vuewm resources can be set for a particular client window or class of client windows. They 
specify client-specific icon and client window frame appearance and behavior. 

Resource identifiers can be either a resource name (e.g., foreground) or a resource class (e.g., 
Foreground). If the value of a resource is a filename and if the filename is prefixed by ""/", then 
it is relative to the path contained in the $HOME environment variable (generally the user's home 
directory). This is the only environment variable vuewm uses directly ($XENVIRONMENT is 
used by the resource manager). 

RESOURCE HIERARCHY 

The resource hierarchy for vuewm takes into account the management of multiple screens and 
multiple workspaces per screen. Screen resources are subresources of vuewm. Workspace 
resources are subresources of each screen name. Depending on the resource being specified, you 
may need to add a screen or workspace component to the resource name to make sure you are 
being specific enough. 

The syntax for a workspace specific resource is: 

Vuemii&screen_name*workspace_name*resourceJd 

If you only want to be screen specific, then the workspace jtame component should be removed. 
Currently, the only workspace specific resources deal with the workspace backdrop. 

COMPONENT APPEARANCE RESOURCES 

The syntax for specifying component appearance resources that apply to window manager icons, 
menus, and client window frames is 

yuewm*resourceJd 

For example, Vuewm*foregrouiid is used to specify the foreground color for vuewm menus, icons, 
and client window frames. 

The syntax for specifying component appearance resources that apply to a particular vuewm com- 
ponent is 

Vuewm'''[menu | icon | client | teeSbacVJ^sourceJd 

limenu is specified, the resource is applied only to vuewm menus; if icon is specified, the resource 
is applied to icons; and if client is specified, the resource is applied to client window frames. For 
example, Vuewm*icon^or^round is used to specify the foreground color for vuewm icons, 
Vuewm*menu*foreground specifies the foreground color for vuewm menus, and 
'Vuewm*client*foregrouiid is used to specify the foreground color for vuewm client window frames. 

The appearance of the title area of a client window frame (including window management but- 
tons) can be separately configured. The syntax for configuring the title area of a client window 
frame is: 

Viiewm*client*title*resoMrce_W 

For example, 'Vuewm*client'''title*foreground specifies the foreground color for the title area. 
Defaults for tide area resources are based on the values of the corresponding client window frame 
resources. 
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Background 




coiat 


varies* 


BackgroundPixmap 




string** 


varies* 


Foreground 




color 


Yaries* 


BottomShado«4>ixmap 




string** 


varies* 


FontList 




string*** 


fixed" 


Foreground 




color 


varies* 


SaveUnder 




T/F 


F 


Background 




color 


varies* 


TopShadoni'ixinap 




string** 


varies* 


d type of the screea 


••Pixmap image 


name. See XmInstallImage(3X). 
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The appearance of menus can be configured based on the name of the menu. The syntax for 
specifying menu appearance by name is: 

'Vaewm*men!a*menu_name*resourceJd 

For example, Vuewin*inenu*my_menu*foreground specifies the foreground color for the menu 
named my_menu. 

The following component appearance resources that apply to all window manager parts can be 
specified: 

Component Appearance Resources - All Window Manager Parts 
Name Class Value l^pc l>«Aiult 

badcground 

badtgroundPixmap 

bottomShadowColor 

bottomShadowPixmap 

font List 

foreground 

saveUnder 

topShadowColor 

topSbadowPixmap 



background (class Background) 

This resource specifies the background color. Any legal X color may be specified. The 
default value is chosen based on the visual type of the screen. 

backgroundPixmap (class BackgroundPixmap) 

This resource specifies the background Pixmap of the vuewm decoration when the win- 
dow is inactive (does not have the keyboard focus). The default value is chosen based on 
the visual type of the screen. 

bottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color. This color is used for the lower and 
right bevels of the window manager decoration. Any legal X color maybe specified. The 
default value is chosen based on the visual ^pe of the screen. 

bottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap. This Pixmap is used for the lower 
and right bevels of the window manager decoration. The default is chosen based on the 
visual type of the screen. 

fontList (class Font) 

This resource specifies the font used in the window manager decoration. The character 
encoding of the font should match the character encoding of the strings that are used. 
The default is "fixed." 

foreground (class Foreground) 

This resource specifies the foreground color. The default is chosen based on the visual 
type of the screen. 

saveUnder (class SaveUnder) 

This is used to indicate whether "save unders" are used for vuewm components. For this 
to have any effect, save unders must be implemented by the X server. If save unders are 
implemented, the X server will save the contents of windows obscured by windows that 
have the save under attribute set. If the saveUnder resource is True, vuewm will set the 
save under attribute on the window manager frame of any client that has it set. If 
saveUnder is False, save unders will not be used on any window manager frames. The 
default value is False. 
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topShadowColor (class Background) 

This resource specifies the top shadow color. This color is used for the upper and left 
bevels of the window manager decoration. The default is chosen based on the visual type 
of the screen. 

topShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow Pixmap. This Pixmap is used for the upper and 
left bevels of the window manager decoration. The default is chosen based on the visual 
type of the screen. 

The following component appearance resources that apply to frame and icons can be specified: 





FVame and Icon Components 




Name 


Class 


Value 1) 


activeBadcground 


Background 


color 


activeBadcgroundPixmap 


BadtgroundPixmap 


string** 


activeBottomSbadowCoIor 


Foreground 


COlOT 


activeBoCtomSbadowPixmap 


BottomShadowPixmap 


string** 


activeForeground 


Foreground 


color 


activeTopShadowCblor 


Badcground 


color 


activ^opShadowPixmap 


TopShadowPixmap 


string** 



DefouK 



*The default is chosen based on the visual type of the screea **See XmInstallImage(3X). 

activeBackground (class Background) 

This resource specifies the background color of the vuewm decoration when the window 
is active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeBackgroundPixmap (class ActiveBackgroundPixmap) 

This resource specifies the background Pixmap of the vuewm decoration when the win- 
dow is active (has the keyboard focus). The default is chosen based on the visual type of 
the screen. 

activeBottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color of the vuewm decoration when the win- 
dow is active (has the keyboard focus). The default is chosen based on the visual type of 
the screen. 

activeBottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap of the vuewm decoration when the 
window is active (has the keyboard focus). The default is chosen based on the visual type 
of the screen. 

activeForeground (class For^round) 

This resource specifies the foreground color of the vuewm decoration when the window 
is active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeTopShadowCoIor (class Background) 

This resource specifies the top shadow color of the vuewm decoration when the window 
is active (has the keyboard focus). The default is chosen based on the visual type of the 
screen. 

activeTopShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow Pixmap of the vuewm decoration when the win- 
dow is active (has the keyboard focus). The default is chosen based on the visual type of 
the screen. 

GLOBAL APPEARANCE AND BEHAVIOR RESOURCES 

The specific appearance and behavior resource have been divided according to their scope. The 
first set of resources can only be specified globally. The second set can be specified on a per- 
screen basis. 
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The s)'ntax for specifying gfo6a/ appearance and behavior resources is 

\utimn*resourceJd 

For example, ^^ewm^keyboardFocusPoIicy specifies the window manager policy for setting the 
keyboard focus to a particular client window. 

The following specific appearance and behavior resources can be specified on a global basis only: 

Global SpeciHc Appearance and Behavior Resources 
Name Class Value T^pe Dcfkult 



autoKeyFocus 


Autcrf(eyFocus 


T/F 


T 


autoRaiseDetay 


AutoRaiseDelay 


millisec 


SOO 


bitmi^Directoiy 


Bitm^Directoiy 


directory 


/usr/indude/XU/bitm^x 


dientAutc^lace 


ClientAutoPlaoe 


T/F 


T 


colonnapFocusPoUcy 


Cokam^FocusPolicy 


string 


ki^board 


configFUe 


CbnfigFile 


file 


(see desertion) 


deiconifyKeyFocus 


Deiconif^C^ocus 


T/F 


T 


doubleClidiTime* 


DoubleClida'ime 


millisec. 


multiOickrime 


enableWarp 


EnableV^ 


T/F 


T 


enforccK^Focus 


EnforoeKeyFocus 


T/F 


T 


iconAutoPlaoe 


IconAutoPlaoe 


T/F 


T 


iconClidi 


IconClick 


T/F 


T 


interactivePlacement 


InteractivePlacement 


T/F 


F 


keyboardFocDsPolicy 


KeyboardFocusPolicy 


string 


ejqplicit 


lowerOnlconify 


LowerOnlconity 


T/F 


T 


moveThreshold 


MoveThreshold 


pixels 


4 


multiscreen 


Multiscreen 


T/F 


F 


passButtons 


PassButtons 


T/F 


F 


passSelectButton 


PassSelectButton 


T/F 


T 


pasitionlsFrame 


PositionlsFrame 


T/F 


T 


positionOnScreen 


PositionOnScreen 


T/F 


T 


quitTimeout 


QuitTimeout 


millisea 


1000 


raiseKeyFocus 


RaiseKeyFocus 


T/F 


F 


screens 


Screens 


string 


varies 


sbcwFeedbadc 


ShowFeedbadc 


string 


all 


starti^KeyFocus 


Startq}KeyFocus 


T/F 


T 


useFrontPanel 


UseFrontPanel 


T/F 


F 


useMessaging 


UseMessaging 


T/F 


F 


wMenuButtonClick 


WMenuButtonClick 


T/F 


T 


wMenuButtonCUck2 


\VMenuButtonClick2 


T/F 


T 


'Included for backward 


compatjblily. You are encoiu-aged to use the Xt resource muttX::ikkTinie. 





autoKeyFocus (class AutoKeyFocus) 

This resource is only available when the keyboard input focus policy is explicit. If 
autoKeyFocus is given a value of True, then when a window with the keyboard input 
focus is withdrawn from window management or is iconified, the focus is set to the previ- 
ous window that had the focus. If the value given is False, there is no automatic setting 
of the keyboard input focus. The default value is True. 

autoRaiseDelay (class AutoRaiseDelay) 

This resource is only available when the focusAutoRaise resource is True and the key- 
board focus policy is pointer. The autoRaiseDelay resource specifies the amount of time 
(in milliseconds) that vuewm will wait before raising a window after it gets the keyboard 
focus. The default value of this resource is 500 (ms). 

clientAutoPiace (class ClientAutoPlace) 

This resource determines the position of a window when the window has not been given 
a user specified position. With a value of True, windows are positioned with the top left 
comers of the frames offset horizontally and vertically. A value of False causes the 



Hewlett-Packard Company 



-10 



HP VUE 2.01 (10/91) 



VUEWM(IX) VUEWM(IX) 



currently configured position of the window to be used. In either case, vuewm will 
attempt to place the windows totally on-screen. The default value is True. 

colormapFocusPolky (class ColormapFocusPolicy) 

This resource indicates the colormap focus policy that is to be used. If the resource 
value is eiplicit then a colormap selection action is done on a client window to set the 
colormap focus to that window. If the value is pointer then the client window containing 
the pointer has the colormap focus. If the value is keyboard then the client window that 
has the keyboard input focus will have the colormap focus. The default value for this 
resource is keyboard. 

configFile (class ConfigFile) 

The resource value is the path name for a vuewm resource description fUe. If none is 
specified, then vuavm searches the following list in order 

$HOME/.vue/$LANG/vuewmrc 
$HOME/.vue/vuewmrc 

/usr/lib/Xll/vue/Vuewm/$LANG/sys.vuewmrc 
/usr/lib/Xll/vue/Vuewm/sys.vuewmrc 

Upon encountering the first such file, vuewm stops the search and uses it. 

deiconifyK^Focus (class DeiconifyK^Focus) 

This resource only applies when the keyboard input focus policy is explicit. If a value of 
True is used, a window will receive the keyboard input focus when it is normalized 
(deiconified). True is the default value. 

iconAutoPlace (class IconAutoPlace) 

This resource indicates whether icons are automatically placed on the screen by vuewm, 
or are placed by the user. Users may specify an initial icon position and may move icons 
after initial placement; however, vuewm will adjust the user-specified position to fit into 
an invisible grid. When icons are automatically placed, vuewm places them into the grid 
using a scheme set with the iconPlacement resource. If the iconAutoPlace resource has a 
value of True, then vuewm does automatic icon placement. A value of False allows user 
placement. The default value of this resource is True. 

iconClick (class IconClick) 

When this resource is given the value of True, the system menu is posted and left posted 
when an icon is clicked. The default value is True. 

interactivePlacement (class InteractivePlacement) 

This resource controls the initial placement of new windows on the screen. If the value is 
True, then the pointer shape changes before a new window is placed on the screen to 
indicate to the user that a position should be selected for the upper-left hand comer of 
the window. If the value is False, then windows are placed according to the initial win- 
dow configuration attributes. The default value of this resource is False. 

keyboardFocusPolicy (class KeyboardFocusPblicy) 

If set to pointer, the keyboard focus policy is to have the keyboard focus set to the client 
window that contains the pointer (the pointer could also be in the client window decora- 
tion that vuewm adds). If set to explicit, the policy is to have the keyboard focus set to a 
client window when the user presses button 1 with the pointer on the client window or 
any part of the associated vuewm decoration. The default value for this resource is e]q>li- 
cit. 

lowerOnlconify (class LowerOnlconify) 

If this resource is given the default value of True, a window's icon appears on the bottom 
of the window stack when the window is minimized (iconified). A value of False places 
the icon in the stacking order at the same place as its associated window. 

moveThreshold (class MoveThreshold) 

This resource is used to control the sensitivity of dragging operations that move windows 
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and icons. The value of this resource is the number of pi^^ls that the locator will be 
moved with a button down before the move operation is initiated. This is used to 
prevent window/icon movement when a click or double-click is done and there is unin- 
tentional pointer movement with the button down. The default value of this resource is 4 
(pixels). 

multiscreen (class MuItiScreen) 

This resource, if True, enables vuewm to manage all the screens on the display. If False, 
vuewm will only manage a single screen on the display. The default value for this 
resource is False. 

passButtons (class FassButtons) 

This resource indicates whether or not button press events are passed to clients after 
they are used to do a window manager function in the client context If the resource 
value is False, then the button press will not be passed to the client If the value is True, 
the button press is passed to the client window. The window manager function is done 
in either case. The default value for this resource is False. 

passSelectButton (class PassSelectButton) 

This resource indicates whether or not the keyboard input focus selection button press 
(if keyboardFocusPolicy is e)q)licit) is passed on to the client window or xised to do a win- 
dow management action associated with the window decorations. If the resource value is 
False then the button press will not be used for any operation other than selecting the 
window to be the keyboard input focus; if the value is True, the button press is passed to 
the client window or used to do a window management operation, if appropriate. The 
keyboard input focus selection is done in either case. The default value for this resource 
is True. 

positionlsFrame (class PositionlsFrame) 

This resource indicates how client window position information (from the 
WM_NORMAL_HINTS property and from configuration requests) is to be interpreted. 
If the resource value is True then the information is interpreted as the position of the 
vuewm client window &ame. If the value is False then it is interpreted as being the posi- 
tion of the client area of the window. The default value of this resource is True. 

positionOnScreen (class PositionOnScreen) 

This resource is used to indicate that windows should initially be placed (if possible) so 
that they are not clipped by the edge of the screen (if the resource value is True). If a 
window is larger then the size of the screen then at least the upper left comer of the win- 
dow will be on-screen. If the resource value is False, then windows are placed in the 
requested position even if totally off-screen. The default value of this resource is True. 

quUTimeout (class QuitTlmeout) 

This resource specifies the amount of time (in milliseconds) that vuewm will wait for a 
client to update the WM_COMMAND property after vuewm has sent the 
WMSAVE YOURSELF message. This protocol will onl y be u sed for those clients that 
have a WNTSAVEYOURSELF atom and no WMDELETEWINDOW atom in the 
WMPROTOCOLS client window property. The default value of this resource is 1000 
(ms). (Refer to the f.kill function for additional information.) 

raiseKeyFocus (class RaiseKQrFocus) 

This resource specifies if the keyboard focus should be given to window that has been 
raised with the £iionnalize_and_raise function. If True, then the window will get the key- 
board focus. The default value is False. 

screens (class Screens) 

This resource is used to provide resource names for the screens to be managed by 
vuewm. The value of this resource is a string containing a blank-separated list of names. 
If fewer names are specified than there are screens on the display, then the remaining 
screens will use the first name in the list 

There is no default value for this resource. The default names for screens are generated 
dynamically depending on the screen type. The dynamic name is a concatenation of the 
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following: 



Name 


Description 


LowRes 


less than 10249^68 


MedRes 


10243^68 


HighRes 
Name 


1280x1024 or better 
Description 


Mono 


less than 16 colors 


LowColor 


16 colors 


MedCblor 


64 colors 



HighColor more than 64 ook»s 

For example, a 1024x768, 2S6-color screen would get a default name of 
HighResHighColor. 

showFeedback (class ShowFeedback) 

This resource controls when feedback information is displayed. It controls both window 
position and size feedback during move or resize operations and initial client placement. 
It also controls window manager message and dialog boxes. The value for this resource 
is a list of names of the feedback options to be enabled; the names must be separated by 
a space. The names of the feedback options are shown below: 



Name 


Description 


aU 


Show aU feedbadL (Default value.) 


behavior 


Confirm behavior switch. 


kill 


Confirm the killing of vuewm with signal. 


move 


Show position during move. 


none 


ShcNV no feedbadc 


placement 


Show position and size during initial placeuKot. 


quit 


Confirm the quitting (f.quit_mwm) of vuewm. 


resize 


Show size during resize. 



restart Confirm vuewm restart. 

The following command line illustrates the syntax for showFeedback: 
Vuewm*showFeedback: placement resize behavior restart 

This resource specification provides feedback for initial client placement and resize, and 
enables the dialog boxes to confirm the restart and set behavior functions. It disables 
feedback for the move function. 

startupK^Focus (class StartupKeyFocus) 

This resource is only available when the keyboard input focus policy is ejq)licit. When 
given the default value of True, a window gets the keyboard input focus when the window 
is mapped (i.e., initially managed by the window manager). 

useFVontPanel (class UseFkvntPanel) 

This resource enables the display of the front panel (also called the "Workspace 
Manager") if True. The default value is False. 

useMessaging (class UseMessaging) 

This resource controls the connection of vuewm to the Broadcast Message Server 
(BMS). If set to True, vuewm will try to connect to the EMS and will participate in inter- 
process messaging with other MP VUE clients. The default value of this resource is 
False. 
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wMenuButtonClick (class WMenuButtonClick) 

This resource indicates whether a click of the mouse when the pointer is over the win- 
dow menu button will post and leave posted the system menu. If the value given this 
resource is True, then the menu will remain posted. True is the default value for this 
resource. 

wMenuButtonClickZ (class WMenuButtonCIickZ) 

When this resource is given the default value of True, a double-click action on the win- 
dow menu button will do an f.kill function. 



SCREEN APPEARANCE AND BEHAVIOR RESOURCES 

The syntax for specifyingper-screen appearance and behavior resources is 

'Vuewm*screen_name*resourceJd 
For example, 'Vuewm'''l'''keyBiiidings specifies the key bindings to use for the screen 1" 



Name 



Screen Specific Appearance and Behavior Resources 
Class Value lype 



I>«fiBlltt 



buttonBindings 


ButtonBindings 


string 


NULL 


cleanText 


QeanText 


T/F 


T 


&deNonnalIcon 


FadeNormalloon 


T/F 


F 


frameBorderWidth 


FrameBorderWidth 


pixels 


5 


iconBoxGeometty 


IconBoEnGeometry 


string 


6x1+0-0 


ioonBoxName 


IconBoxName 


string 


icodbcK 


iconBoxSBDisplayPolicy 


IconBoxSBDisplayPoUcy 


string 


all 


iconBcsa'itle 


IconBogO'itle 


string 


Icons 


iconDecoration 


IconDecoration 


string 


varies 


iconlmageMaximuin 


IconlmageMaximum 


wxh 


SOxSO 


iconlmageMinimum 


IconlmageMinimum 


wxh 


32302 


iconPlacement 


IconPlacement 


string 


left bottom 


iconPlacementMargin 


IconPlacementMargin 


pixels 


varies 


keyBindings 


KeyBitxlings 


string 


Motif 


limitResize 


LimitResize 


T/F 


T 


maxunumMaximumSize 


MaximimiMaximumSize 


ivxh (pixels) 


2X screen w&h 


nxweOpaque 


MweOpaque 


T/F 


F 


pushButtonClidsTime 


PushButtanClidsTime 


millisec. 


4 X multiClidkTime 


resizeBorder\^ridth 


ResizeBorderWidth 


pixels 


10 


resizeCursors 


ResizeCursors 


T/F 


T 


transientDeooration 


IVansientDecoration 


string 


system title 


transientFunctions 


lYansientFuDctions 


string 


-minimize -maximize 


useBliokinglndicator 


UseBlinkinglndicator 


T/F 


T 


uselconBoK 


UselconBoK 


T/F 


F 


woricspaceList 


WoilcspaceList 


string 


NULL 



bitmapDirectory (class BitmapDirectory) 

This resource identifies a directory to be searched for bitmaps referenced by vuewm 
resources. This directory is searched if a bitmap is specified without an absolute path- 
name. The default value for this resource is "/usr/include/Xll/bitmaps". 

Note that all images used in the front panel are fetched using the directory search path of 
XmGetPixmapO. By default, front panel images are found in directory 
/usr/lib/Xll/bitmaps/Viiewm. 

buttonBindings (class ButtonBindii^s) 

This resource identifies the set of button bindings for window management functions. 
The named set of button bindings is specified in the vuewm resource description file. 
These button bindings are merged with the built-in default bindings. The default value 
for this resource is NULL (i.e., no button bindings are added to the built-in button 
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bindings). 

clearText (classClearfText) 

This resource controls the display of window manager text in the client title and feedback 
windows. If the default value of True is used, the text is drawn with a clear (no stipple) 
background. This makes text easier to read on monochrome systems where a back- 
groundPixmap is specified. Only the stippling in the area immediately around the text is 
cleared. If False, the text is drawn directly on top of the existing background. 

fadeNormallcon (class FadeNomiallcon) 

If this resource is given a value of True, an icon is grayed out whenever it has been nor- 
malized (its window has been opened). The default value is False. 

frameBorderWidth (class ErameBorderM^dth) 

This resource specifies the width (in pixels) of a client window frame border without 
resize handles. The border width includes the 3-D shadows. The default value is S pix- 
els. 

iconBoxCeometiy (class IconBoxGeometiy) 

This resource indicates the initial position and size of the icon box. The value of the 
resource is a standard window geometry string with the following syntax: 

[ = ][widthT(height][{ + ■}xoffset{ + '}yoffiei\ 

If the offsets are not provided, the iconPlacement policy is used to determine the initial 
placement. The units for width and height are columns and rows. The actual screen size 
of the icon box window will depend on the iconlmageMaximum (size) and iconDecora- 
tion resources. The default value for size is (6 * iconWidth + padding) wide by (1 * 
iconHeight + padding) high. The default value of the location is +0-0. 

IconBoxName (class IconBoxName) 

This resource specifies the name that is used to look up icon box resources. The default 
name is iconbox. 

iconBoj^itle (class IconBoj^itle) 

This resource specifies the name that is used in the title area of the icon box frame. The 
default value is Icons. 

iconBoxSBDisplayPolicy (class IconBoxSBDisplayPolicy) 

This resource is used to set the scroll bar display policy for the icon box. The possible 
values for this resource are: 

all Display both scroll bars. 

horizontal Display only horizontal scroll bar. 

vertical Displayonlyvertical scroll bar. 

If only one scroll bar is displayed, the icons in the icon box are laid out so that all can be 
accessed and the scroll bar is displayed only when needed. The default value is all. 

iconDecoration (class IconDecoration) 

This resource specifies the general icon decoration. The resource value is laber(only 
the label part is displayed) or image (only the image part is displayed) or label image 
(both the label and image parts are displayed). A value of activelabel can also be 
specified to get a label (not truncated to the width of the icon) when the icon is selected. 
The default icon decoration for icon box icons is that each icon has a label part and an 
image part (label image). The default icon decoration for stand-alone icons is that each 
icon has an active label part, a label part and an image part (activelabel label image). 

iconlmageMaximum (class IconlmageMaximum) 

This resource specifies the maximum size of the icon imagz. The resource value is 
widthxheight (e.g., 64x64). The maximum supported size is 128x128. The default value of 
this resource is 50x50. 

iconlmageMinimum (class IconlmageMinimum) 

This resource specifies the minimum size of the icon imagji. The resource value is 
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widthxheigftt (e.g., 32x50). The minimum supported size is 16x16. The default value of 
this resource is 32x32. 

iconPIacement (class IconPlacement) 

This resource specifies the icon placement scheme to be used. The resource value has 
the following ^tax: 

primary Jayout secondaiyje^out 

The layout values are one of the following: 

top Lay the icons out top to bottom. 

bottom Lay the icons out bottom to top. 

left Lay the icons out left to right 

right Lay the icons out right to left 

A horizontal (vertical) layout value should not be used for both the pritnay Jayout and 
the secondary Jayout (e.g., don't use top for the primary Jayout and bottom for the 
secondary JayouC). The primary Jayout indicates whether, when an icon placement is 
done, the icon is placed in a row or a column and the direction of placement The 
secondary Jayout indicates where to place new rows or columns. For example, top right 
indicates that icons should be placed top to bottom on the screen and that columns 
should be added from right to left on the screen. The default placement is left bottom 
(icons are placed left to right on the screen, with the first row on the bottom of the 
screen, and new rows added from the bottom of the screen to the top of the screen). 

iconPlacementMargin (class IconPlacementMargin) 

This resource sets the distance between the edge of the screen and the icons that are 
placed along the edge of the screen. The value should be greater than or equal to 0. A 
default value (see below) is used if the value specified is invalid. The default value for 
this resource is equal to the space between icons as they are placed on the screen (this 
space is based on maximizing the number of icons in each row and column). 

keyBindii^s (class K^Bindii^s) 

This resource identifies the set of key bindings for window management functions. If 
specified these key bindings replace the built-in default bindings. The named set of key 
bindings is specified in vuewm resource description file. The default value for this 
resource is the set of compatible key bindings. 

limitResize (class LimitResize) 

If this resource is True, the user is not allowed to resize a window to greater than the 
maximum size. The default value for this resource is True. 

maximumMaximumSize (class MaximumMaxunumSize) 

This resource is used to limit the maximum size of a client window as set by the user or 
client The resource value is widthjcheight (e.g., 1024x1024) where the widdi and height 
are in pixels. The default value of this resource is twice the screen width and height 

moveOpaque (class MoveOpaque) 

This resource is used to set the style of feedback provided during window moves. If True, 
the entire window is moved as feedback (at the cost of some degradation in perfor- 
mance). If False, only a window outline is moved. The default value of this resource is 
False. 

pushButtonClickTime (class PushButtoitClickTime) 

This resource controls the amount of time (in milliseconds) that pushbuttons in the front 
panel will be disabled after their initial press. The default value of this resource is 4 
times the multiQickTime set for the window manager, or 2 seconds of wait time. The 
reason for the delay is to suppress multiple application invocation from users doub- 
leclicking on pushbuttons. 

resizeBorder^dth (class ResizeBorderWidth) 

This resource specifies the width (in pixels) of a client window frame border with resize 
handles. The specified border width includes the 3-D shadows. The default is 10 
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(pixels). 

resizeCursors (class ResizeCursors) 

This is used to indicate whether the resize cursors are always displayed x^en the pointer 
is in the window size border. If True the cursors are shown, otherwise the window 
manager cursor is shown. The default value is True. 

transientDecoration (class lYansientDecoration) 

This controls the amount of decoration that Vuewm puts on transient windows. The 
decoration specification is exactly the same as for the clientDecoration (client specific) 
resource. Transient windows are identified by the WMTRANSIENTFOR property 
which is added by the client to indicate a relatively temporary window. The default value 
for this resource is menu title (i.e., transient windows will have resize borders and a 
titlebar with a window menu button). 

transientFunctions (class IVansientEunctions) 

This resource is used to indicate which window management functions are applicable (or 
not applicable) to transient windows. The function specification is exactly die same as 
for the clientF^nctions (client specific) resource. The default value for this resource is 
-minimize -maximize. 

useBIinkinglndicator (class UseBlinkinglndicator) 

This resource enables the operation of the blinking activity light in the front panel. If 
True, the blinking activity light will flash if configured into the front panel. If False, the 
light will not flash; instead, the second bitmap specified for the vuewmbusy control will 
be installed in the front panel for the wait duration. The default value is True. 

uselconBox (class UselconBox) 

If this resource is given a value of True, icons are placed in an icon box. When an icon 
box is not used, the icons are placed on the root window (default value). 

workspaceList (class WorkspaceList) 

This resource specifies the resource names and number of the workspaces to create for a 
screen. The value of this resource is a list of names separated by blanks. The names 
specified in this resource are used to fetch resources with. Consequently, a workspace 
name should not contain any of the following characters: asterisk (*), period (.), colon 
(:), quote ("), or backslash (\). 

Example: 

Vuewm*0*workspaceList: A B C D E F 

This creates six workspaces for screen 0. 



CLIENT SPECIFIC RESOURCES 

The syntax for specifying client specific resources is 

yfuemn{*screenjtame]*client_name_or_class*resource_id 

For example, Vuewni*mterm*windowMenu is used to specify the window menu to be used with 
mterm clients. 

The syntax for specifying client specific resources for all classes of clients is 

'Vuewm*resource id 

Specific client specifications take precedence over the specifications for all clients. For example, 
Vuewm*wiiidowMenu is used to specify the window menu to be used for all classes of clients that 
don't have a window menu specified. 

The syntax for specifying resource values for windows that have an unknown name and class (i.e. 
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the window does not have a WM_CLASS property associated with it) is 

yaemaL*d^ults*resource_id 

For example, Vuewm*deflEiults*iconImage is used to specify the icon image to be used for windows 
that have an unknown name and class. 

The following client specific resources can be specified: 



Client Specific Resources 



Value lypc 



clientDecoration 


ClieittDeaM^ian 


string 


all 


clieatFunctions 


ClientFunctions 


string 


all 


tocusAatoRaise 


FocusAutoRaise 


T/F 


T 


ioanlmage 


loonlmage 


pathname 


(image) 


ioonlmageBackground 


Background 


odor 


icon background 


iconlmageBottomSbadowColor 


Foreground 


cxd<s- 


iorai bottran shadoa^ 


iconlniageBottoinShadowPixm^ 


BottcnnShadcin^ixm^ 


string* 


iocm bottcnn shadcw pixmq> 


ioonlmagcForeground 


Foreground 


color 


icon foreground 


ioonImageTopShado«vColor 


Background 


color 


icon top shadow ookM- 


iconlmageTopShadowPixmap 


TopShadcrwPixmap 


string* 


ioon top shadcmr pixmq> 


matteBadcgrouDd 


Background 


color 


badcground 


matteBottomShadowColor 


Foreground 


color 


bottom shadonr color 


matteBottomShadowPixmap 


BottomSbadotvPixniap 


string* 


bottom sbadonr pixmap 


matteForeground 


Foreground 


color 


fraeground 


matteTopShadowCblor 


Badcground 


color 


top shadow color 


matteTopShadowPixmap 


TopShado«i>ixmap 


string* 


top shadow pixm^ 


matteWidth 


MatteWidth 


pixels 





maximuinClientSize 


MaximuinClientSize 


wxh 


fill the screen 


useClientlcon 


UseClientlcon 


T/F 


F 


windonrMenu 


\WndowMenu 


string 


string 


•See XinInstallImage(3X). 









clientDecoration (class ClientDecoration) 

This resource controls the amount of window frame decoration. The resource is 
specified as a list of decorations to specify their inclusion in the frame. If a decoration is 
preceded by a minus sign, then that decoration is excluded from the frame. The «g» of 
the first item in the list determines the initial amount of decoration. If the sign of the 
first decoration is minus, then vuewm assumes all decorations are present and starts sub- 
tracting &om that set. If the sign of the first decoration is plus (or not specified), then 
vuewm starts with no decoration and builds up a list from the resource. 



Name 


Description 


all 


Include all decorations (defoult value). 


border 


Window border. 


maximize 


Maximize button (includes title bar). 


minimize 


Minimize button (includes title bar). 


none 


No decorations. 


resizeh 


Border resize handles (includes border). 


menu 


Wvadaw menu button (includes title bar). 


title 


Title bar (includes border). 



Examples: 

Vuewm*XClock*cIientDecoration: -resizeh -maximize 

This removes the resize handles and maximize button from XClock windows. 



Hewlett-Packard Company 



-18- 



HP VUE 2.01 (10/91) 



VUEWM(IX) VUEWM(IX) 

>^ainn*XClock*cIientDecoration: menu minimize border 
This does the same thing as above. Note that either menu or minimize implies title. 

clientFVinctions (class CiientfVinctions ) 

This resource is used to indicate which vuewm functions are applicable (or not applica- 
ble) to the client window. The value for the resource is a list of functions. If the first 
function in the list has a minus sign in &ont of it, then vuewm starts with all functions 
and subtracts from that set. If the first function in the list has a plus sign in front of it, 
then vuewm starts with no functions and builds up a list Each function in the list mxist 
be preceded by the appropriate plus or minus sign and be separated from the next func- 
tion by a space. 

The table below lists the functions available for this resource: 



Name 


Description 


aU 


Include all fuactkmt (defoult value) 


none 


No functions 


resize 


tresize 


move 


f.mcwe 


mimmize 


f.minimize 


maxiinize 


Lmaxiniize 


close 


fJull 



focusAutoRaise (class FocusAutoRaise) 

When the value of this resource is True, clients are made completely unobscured when 
they get the keyboard input focus. If the value is False, the stacking of windows on the 
display is not changed when a window gets the keyboard input focus. The default value 
is True. 

iconlmage (class Iconlmage) 

This resource can be used to specify an icon image for a client (e.g., 
Vuewm*myclock*iconImage). The resource value is a pathname for a bitmap file. The 
value of the (client specific) useClientlcon resource is used to determine whether or not 
user supplied icon images are used instead of client supplied icon images. The default 
value is to display a built-in window manager icon image. 

iconlmageBackground (class Background) 

This resource specifies the background color of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon background color 
(i.e., specified by Vuewm 'background or Vuewm*icon 'background). 

iconlmageBottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color of the icon image that is displayed in 
the image part of an icon. The default value of this resource is the icon bottom shadow 
color (i.e., specified by Vuewm*icon*bottomShadtwvColor). 

iconlmageBottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap of the icon image that is displayed in 
the image part of an icon. The default value of this resource is the icon bottom shadow 
Pixmap (i.e., specified by Vuewm*icon*bottomShadowPixmap). 

iconlmageForeground (class Foreground) 

This resource specifies the foreground color of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon foreground color 
(i.e., specified by Vuewm*foreground or Vuewm*icon*foreground). 

iconlmageTopShadowColor (class Background) 

This resource specifies the top shadow color of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon top shadow color 
(i.e., specified by Vuewm*icon*topShadowColor). 
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iconlmageTopShadowPixniap (class TopShadowPixinap) 

This resource specifies the top shadow Pixmap of the icon image that is displayed in the 
image part of an icon. The default value of this resource is the icon top shadow Pixmap 
(i.e., specified by Vuewm*icon*topShadowPixmap). 

matteBackground (class Background) 

This resource specifies the background color of the matte, when matteWidth is positive. 
The default value of this resource is the client background color (i.e., specified by 
Vuewm 'background or Vuewm*client*background). 

matteBottomShadowColor (class Foreground) 

This resource specifies the bottom shadow color of the matte, when ntatteVi^dth is posi- 
tive. The default value of this resource is the client bottom shadow color (i.e., specified 
by Vuewm*bottomShadowColor or Vuewm*client*bottomShadowColor). 

matteBottomShadowPixmap (class BottomShadowPixmap) 

This resource specifies the bottom shadow Pixmap of the matte, when matteWidth is 
positive. The default value of this resource is the client bottom shadow Pixmap (i.e., 
specified by Vuewm*bottomShadowPixmap or Vuewm*client*bottomShadowPixmap). 

matteForeground (class For^round) 

This resource specifies the foreground color of the matte, when matteWidth is positive. 
The default value of this resource is the client foreground color (i.e., specified by 
Vuewm*foreground or Vuewm*client*foreground). 

matteTopShadowColor (class Background) 

This resource specifies the top shadow color of the matte, when matteWidth is positive. 
The default value of this resource is the client top shadow color (i.e., specified by 
Vuewm*topShadowColor or Vuewm*cIient*topShadowColor). 

matteTopShadowPixmap (class TopShadowPixmap) 

This resource specifies the top shadow Pixmap of the matte, when matteMdth is posi- 
tive. The default value of this resource is the client top shadow Pixmap (i.e., specified by 
Vuewm*topShadowPixmap or Vuewm*client*topShadowPixmap). 

matteWidth (class MatteWidth) 

This resource specifies the width of the optional matte. The default value is 0, which 
effectively disables the matte. 

maximumCIientSize (class MaximumClientSize) 

This is a size specification that indicates the client size to be used when an application is 
maximized. The resource value is specified as widthjiheight. The width and height are 
interpreted in the units that the client uses (e.g., for terminal emulators this is generally 
characters). If this resource is not specified then the maximum size from the 
WM_NORMAL_HINTS property is used if set. Otherwise the default value is the size 
where the client window with window management borders fills the screen. When the 
maximum client size is not determined by the maximumCIientSize resource, the max- 
imumMaximumSize resource value is used as a constraint on the maximum size. 

useCIientlcon (class UseCIientlcon) 

If the value given for this resource is True, then a client supplied icon image will take 
precedence over a user supplied icon image. The default value is False, making the user 
supplied icon image have higher precedence than the client supplied icon image. 

windowMenu (class WindowMenu) 

This resource indicates the name of the menu pane that is posted when the window 
menu is popped up (usually by pressing button 1 on the window menu button on the 
client window frame). Menu panes are specified in the vuewm resource description file 
file. Window menus can be customized on a client class basis by specifying resources of 
the form Vuewm*c/iem_/jamc_or_c/ay5*windowMenu (see vuewmrc(4)). The default 
value of this resource is the name of the built-in window menu specification. 
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FRONT PANEL RESOURCES 

The front panel is an integral part of vuewm. However, from a resource perspective, it looks more 
like a client. The syntax for specifying front panel resources is: 

\uema\^screenjtame\*frontj>aneljiam(i*resourceJd 

For example, Vuewm*froiitPaneI*numberOfSwitchRows is used to specify the number of rows of 
workspace buttons. 

The following resources are used to configure the front panel. 





FVont Panel Resources 




Name 


Class 


Value ly 


borderWdth 


BorderWidth 


pixels 


clientTimeoutlnterval 


ClientTimeoutlnteival 


millisec 


control^iacuig 


CoDtrolS^MCuig 


pixels 


geometry 


Geometiy 


string 


name 


Name 


string 


numberOfSwitchRows 


NumbeiOtSwitchRows 


integer 


rcwS^cing 


Row^jadng 


pixels 


wsButtonBorder 


V^ButtonBorder 


pixels 


wsButtonShadoAThidcness 


WsButtonShadonnrbickness 


pixels 


wsButtonS^cing 


WsButtonS^cing 


pixels 


waitingBlinkRate 


WaitingBlinkRate 


millisec 



DefkuU 





20000 



dynamic 

varies 

2 



10 

2 

4 

SOO 



borderWidth (class Border\^dth) 

This resource controls the border, or margin, between the rows of controls and the sur- 
rounding front panel frame. The default value is 0. 

clientTimeoutlnterval (class ClientTimeoutlnterval) 

This resource specifies the time that vuewm will wait for a window to appear that is 
invoked by a front panel action. In many cases, there is a delay between the time a con- 
trol is activated and the time a client window appears. This resource specifies the time 
that vuewm will wait for the window before assuming that the activation failed. The 
default value of this resource is 60000 ms, or 60 seconds. 

Typically, the activity light on the front panel blinks and a front panel hourglass appears 
until either the timeout interval has expired or the client window appears on the screen. 

controlSpacing (class ControlSpacing) 

This resource specifies the spacing between controls in pixels, including the beveling. 
The default value is 0. (See also shadoWThickness.) 

geometry (class Geometry) 

This resource specifies the placement of the front panel on the screen, using a simplified 
form of the standard window geometry. The value is determined dynamically. The 
default is to center the front panel at the bottom of the screen. 

Of the standard vwndow geometry string: 

[=]\mdthisheigfti\[{+-}xojfset{-\--}yojfsei\ 

-only the plus and minus forms of the xoffset and yoffset are used. A given width or 
height will be ignored, because vuewm determines the overall width and height of the 
front panel from the controls within it. 

For example, =-10+5 places the front panel at the upper right of the screen, indented 
from the left edge by 10 pixels and down from the top edge by 5 pixels. 

Note that the top row of controls determines the overall width of the front panel—this 
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width will be detennined by the width of controls in the top row. 

If the xojfset is positive, then the front panel will be left-justified by the specified pijffil 
spacing; if the xoffset is negative, the front panel will be right-justified; if the xoffset is -0 
or +0, the front panel will be centered horizontally. 

If the yoffset is positive (including +0), the front panel will be ofiEset from the top of the 
screen by the specified number of pixels; if the yoffset is negative (including -0), the front 
panel will be offset from the bottom of the screen. 

The default geometry is -0-0. 

name (class Name) 

This resource sets the name of the front panel. This name is used to look up the front 
panel specification in the vuewmrc file. The default value is dynamically determined 
based on the screen resolution type— it may be LargeFrontPanel (typically, 1280 by 1024 
pixels), MediumFrontPanel (typically, 1024 by 768 pixels), or SmaUFrontPanel. 

numberOfSwitchRows (class NumberOfSwitchRows) 

This resource sets the number of rows in the workspace switch. The default value is 2. 
The numberOiSwitchRows front panel resource and the workspaceList screen resource 
work together to determine the button placement within the workspace switch. For 
example, together Vuewm*numberOfSwitchRows: 4 and Vuewm*workspaceList: 
<namel> <name2> <name3> <name4> <name5> <name6> <name7> <name8> 
specify a workspace switch having eight workspace buttons arranged into four rows of 
two buttons. 

The overall size of the workspace switch (which determines the maximum workspace but- 
ton size) is set in the resource description file. 

rowSpacing (class RowSpacing) 

This resource sets the spacing in pixels between rows of controls in the front panel. The 
default value is 0— vuewm stacks the controls so that there is no spacing between the 
rows. 

wsButtonBorder (class WsButtonBorder) 

This resource sets the border width for the buttons in the workspace switch— the margin 
between the rows of buttons and the frame of the workspace switch. The default value of 
this resource is 10. 

This resource also controls the vertical inter-button spacing of the workspace switch— the 
spacing between workspace buttons rows is 2 less than the wsButtonBorder (but always 
nonnegative). 

wsButtonShadoviTliickness (class WsButtonShadoWThickness) 

This resource sets the shadow thickness (or beveling) for the buttons in the workspace 
switch. The default value is 2. 

wsButtonSpacing (class WsButtonSpacing) 

This resource sets the horizontal spacing between the buttons in the workspace switch. 
The default value is 10. 

From these resource values, vuewm computes the sizes and layout of the buttons them- 
selves in the workspace switch. 

waitingBIinkRate (class WaitingBlinkRate) 

This resource sets the rate of the busy light. The time set by this resource measures a 
half cycle of the busy light blink frequency. The light is on for this amount of time before 
being turned off for the same amount of time. The default value is 500 milliseconds. 
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FRONT PANEL ROW RESOURCES 

The front panel is organized into one or more rows of controls. Each row can have a name 
specified in the resource description file. You can specify color sets and background patterns on a 
per-row basis. The syntax for specifying front panel row resources is: 

Yuewm[*screen_name]*row_name*resource_id 

For example, 'Viiewm'*Top*rowBackgrouiidPixinap: 75_for^round causes vuewm to create a back- 
ground for the row named Top using a 75Jbreffvund pattern. 

The following resources are used to configure individual rows of the front panel. 

Fi-ont Panel Row Resources 

Name Class Value lypc DcAiult 

colorSetId ColorSetId integer, / to ^ dynamic 

rowBadcgroundPixmap RowBadigroundPixmap image_name NULL 

colorSetId (class colorSetId) 

This resource sets the color set (with background, foreground, topshadow, and bot- 
tomshadow colors) for the specified row. The default value for this resource is deter- 
mined dynamically, based on the color type of the screen. 

rowBackgroundPixmap (class RowBackgroundPixmap) 

This resource sets the background pattern to use behind the controls in a given row. 
The default value is NULL, or no background pixmap. 

Note that a background pixmap will underlie all the controls in the specified row(s). 

VUEWMDATE RESOURCES 

Vuewmdate is a psuedo-client that shows you the current date, like a desk-top calendar. It is built 
into vuewm. The format of the date display can include multiple lines and multiple fonts. The date 
format is configurable through the use of strftime (3). 

The syntax for specifying resources for vuewmdate is: 

yuewm*yuewmdat«*resource id 

For example, Vuewm^vuewmdate^fontListl is used to specify a fontList for the first line of the 
vuewmdate display. 

The following resources are used to configure vuewmdate. 

Vuewmdate Resources 

Name Class Value Type DeCault 

fontList FontList string fixed" 

fontListl FontList string fontList 

fontList2 FontList string fontList 

fontListS FontList string fontList 

fontList4 FontList string fontList 

fontListS FontList string fontList 

format Format string '%b%n%.l%n%a* 

fontList (class FontList) 

This resource describes the font to use for the text in the date display. The default value 
is "fixed". 

fontListl (class FontList) 

This resource describes the font to use in the first line of the date display. The default 
value of this resource is the value of vuewmdate's fontList resource. 
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fontList2 (class FontList) 

This resource describes the font to use in the second line of the date display. The default 
value of this resource is the value of vuewmdate's fontList resource. 

fontListS (class FontList) 

This resource describes the font to use in the third line of the date display. The default 
value of this resource is the value of vuewmdate's fontList resource. 

fontList4 (class FontList) 

This resource describes the font to use in the fourth line of the date display. The default 
value of this resource is the value of vuewmdate's fontList resource. 

fontListS (class FontList) 

This resource describes the font to use in the fifth line of the date display. The default 
value of this resource is the value of vuewmdate's fontList resource. 

format (class Format) 

This resource provides the format string for the vuewmdate date. The format string is 
passed to strftime(3) for interpretation. The character string returned from that function 
is parsed for new lines and displayed appropriately in the vuewmdate area. The default 
value for this resource is '^b%n%.ld%n%a". 



WORKSPACE RESOURCES 

The only workspace resource is the title resource. The title of a workspace appears in the 
workspace button in the workspace switch. It is a user-visible name for the workspace ^ereas the 
workspace name given in the workspaceList resource is used for fetching resources. 

The syntax for specifying the workspace title resource is: 

yuewm[*screen_name]*workspacejumte/*title 

For example, Viiewm*0*A*title is used to set the title of workspace A on screen 0. Note that 
workspace juane must appear elsewhere in the workspaceList resource. 

The following table describes the workspace title resource. 

Workspace Tkk Resource 
Name Class Valutiypc D«fault 

title Title XnaString varies* 

*The default title is the workspace name. 

title (class Title) 

This resource specifies the user-visible title of a workspace. The default value is the 
workspace name (as given in the workspaceList resource). 



BACKDROP RESOURCES 

The backdrop resources are the only resource that can be specified on a per-workspace basis. 
These resource set the backdrop bitmap image and colors to be used for that workspace. 

The syntax for specifying backdrop resources is: 

yuema{*screenjiame\[*workspacejiame\*hac\iATOp^sourceJd 

For example, Vuewm*0*Main*backdrop'*image is used to set the backdrop bitmap image for the 
Main workspace on screen 0. 

The following resources are used to configure vuewmdate. 
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Backdrop Resources 

Name Class Value Type D«teiilt 

colotSetId CcdmSetld integer NULL 

image Image string "none' 

imageBadcgrouad ImageBadcground pixel varies* 

imageForeground ImageForeground pixel varies* 
*The default is chosen based on the display type. 

colorSetId (class ColorSetId) 

This resource specifies a color set to use for the backdrop. This is normally an integer 
from 1 to 8. The default value of this resource is display dependent 

imiBge (class Image) 

This resource specifies a bitmap image to use as the backdrop. If "none" is specified, 
then no backdrop image will be used. The root vnndow will show through. A bitmap file 
can be specified, provided it is preceded by a '@' character. If the first four letters in the 
base name of the bitmap file are "deep", tiien vuewm will create a 3D shaft with the bit- 
map image at the "bottom". Image files are fetched using the directory search path of 
XmG«tPixinap(). 

The default value for this resource is none (no image). 

imageBackground (class ImageBackground) 

This resource specifies a color to use as the background color of the backdrop. If not 
specified, this color will default to a pixel value that can be dynamically customized with 
the color customizer, providing you are running in the HP VUE. If this resource is 
specified, a color cell will be allocated outside of any dynamically customizable set The 
default value varies based on the screen type. 

imageForeground (class ImageForeground) 

This resource specifies a color to use as the foreground color of the backdrop. If not 
specified, this color will default to a pixel value that can be dynamically customized with 
the color customizer, providing you are running in the HP VUE. If this resource is 
specified, a color cell will be allocated outside of any dynamically customizable set The 
default value varies based on the screen type. 



DIALOG RESOURCES 

The titles of the Workspace Rename and Workspace Presence dialog are settable via resources. 

The syntax for setting the Workspace Rename title is: 

'Vuewm*5creen_na/ne*workspaceController*title 

Similarly, the syntax for setting the Workspace Presence title is: 
Vuewm*^creert_na/ne*workspacePresence*title 

The title subresource is described below: 

Workspace Diakig Resources 
Name Class Value Type 

title Title XmString 

*The default name of the dialog: "Workspace Rename" or "Workspace Presence". 

title (class Title) 

This resource specifies the title of a workspace dialog. The default value varies based on 
the dialog. 
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RESOURCE DESCRIPnON FILE 

The vuewm resource description file is a supplementaiy resource file that contains resource 
descriptions that are referred to by entries in the defaults files (.Xdefaults, app-defaults/Vuewm). 
It contains descriptions of resources that are to be used by vuewm, and that cannot be easily 
encoded in the defaults files. 

The following types of resources can be described in the vuewm resource description file: 

Buttons Window manager functions can be bound (associated) with button events. 

Front Panel The vuewm front panel can be configured for a custom content or layout 

Kq^s Window manager functions can be bound (associated) with key press events. 

Menus Menu panes can be used for the window menu and other menus posted with key 

bindings and button bindings. 

Use vuewm resources (such as vuewm*windowMenu and vuewm*frontPanelName) described on 
the preceding pages to select which corresponding description to use from the resource descrip- 
tion file. 

ENVIRONMENT 

Viiewm uses the environment variable $HOME specifying the user's home directory. 

Viiewm uses thfe environment variable $MWMSHELL (first) or $SHELL (second) for specifying 
the user's shell in carrying out f.exec functions. (If neither variable is set, vuewm uses /bin/sh.) 

Vuewm uses the environment variable $LANG to specify the location of the resource description 
file and its localized message file. 



FILES 



$HOME/.vue/$LANG/vuewmrc 

$HOME/.vue/vuewmrc 

/usr/lib/Xll/vue/Vuewm/$LANG/sys.vuewmrc 

/usr/lib/Xll/vue/Vuewm/sys.vuewmrc 

/usr/lib/Xll/bitmaps/Vuewm/ * 

/usr/lib/nls/$LANG/vuewm.cat 

$HOME/.Xdefaults 

/usr/Iib/Xll/app-defaults/Vuewm 



COFYRIGHT 

(c) Copyright 1989, 1990 by Open Software Foundation, Inc. 

(c) Copyright 1987, 1988, 1989, 1990 by Hewlett-Packard Company 

All rights reserved. 

ORIGIN 

Hewlett-Packard Company ITO. 

SEE ALSO 

vuesession(lX), vuestyle(lX), X(l), VendorSh«U(3X), strftime(3), XmInstaIlImage(3X), 
XmGetPixmap(3X), and vuewmrc(4X). 
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NAME 

vuewmrc - The HP VUE Workspace Manager Resource Description I^le. 

DESCRIPTION 

The vuewm resource desaipUon file is a supplementary resource file that controls much of the 
operation of the HP Visual User Environment Window Manager (yuewm). It contains descrip- 
tions of resources that are to be used by vuewm, and that cannot be easily written using standard 
X Window System, Version 11 resource syntax 
^fuwnn*resouKeJd 

The resource description file contains entries that are cross-referenced by entries in the resource 
defaults files (for example, ^sr/lib/Xll/app-defoults/Viiewm). For example, the resource 
description file enables you to specify different types of window menus; on the other hand, the 
default resource file enables you to specify which of these window menus the manager should use 
for a particular window. 

The specifications of the resource description file supported by the HP VUE workspace mana^r 
are a strict superset of the specifications supported by the HP/OSF Motif Window Manager 
(mwm 1.0). In other words, the ^sr/lib/Xll/i^tem.mwmrc or $HOME/jnwmrc file that you've 
used for mwm is immediately usable by vuewm: Simply open the vuewm resource description file 
with a text editor (make a copy first!), then cut and paste specifications from your current jiiwmrc 
file into it. When you restart the workspace manager, your menu, key, and button definitions will 
take immediate effect 

Location 

The workspace manager searches for one of the following resource description files, where SLANG 
is the value of the language environment on a per-user basis: 

$HOME/.vue/$LANG/vuewmrc 

$HOM£/.vue/vuewmrc 

/usr/lib/Xll/vue/Vuewm/$LANG/sys.vuewmrc 

/usr/lib/Xll/vue/Vuewm/sys.vuewmrc 

The first file found is the first used. 

If none is found, then a set of built-in specifications is used. For example, the front panel, if used, 
will consist solely of the workspace switeh (a set of buttons for changing workspaces). 

A particular resource description file can be selected using the configFile resource. 

The following shows how a different resource description file can be specified from the command 
line: 

/usr/bin/Xll/niewm -xrm "Vuewm*conngFile: myvuewmrc* 

Resource Types 

The following types of resources can be described in the vuewm resource description file: 

Buttons Workspace manager functions can be bound (associated) with button events. 

Keys Workspace manager functions can be bound (associated) with key press events. 

Menus Menu panes can be used for the window menu and other menus posted with key 

bindings and button bindings. 

Front Panel The vuewm front panel can be configured for a custom content or layout. 

VUEWM RESOURCE DESCRIPTION FILE SYNIAX 

The vuewm resource description file is a standard text file that contains items of information 
separated by blanks, tabs, and new lines characters. Blank lines are ignored. Items or characters 
can be quoted to avoid special interpretation (e.g., the comment character can be quoted to 
prevent it from being interpreted as the comment character). A quoted item can be contained in 
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double quotes ("). 

Single characters can be quoted by preceding them by the back-slash character (\), e»;ept for 
workspace names, which may contain no back-slash characters. 

All text from an unquoted # to the end of the line is regarded as a comment and is not inter- 
preted as part of a resource description. If t is the first character in a line, the line is regarded as a 
comment. 

Workspace Manager Functions 

Workspace manager functions can be accessed with button and key bindings, and with workspace 
manager menus. Functions are indicated as part of the specifications for button and key binding 
sets, and menu panes. The function specification has the following syntax: 

function = Junction jtame \fitnction at;gs] 

junction jiame = workspace manager fun<^n 
function jir^ = {quoted Jtem \ unquoted Jtem) 

The following functions are supported. If a function is specified that isn't one of the supported 
functions then it is interpreted by vuewm as f. nop. 

taction This function causes the specified action to be invoked by means of the message 
server. 

flbe^ This function causes a beep. 

£circIe_down [icon | window] 

This Unction causes the window or icon that is on the top of the window stack to 
be put on the bottom of the window stack (so that it is no longer obscuring any 
other window or icon). This function affects only those windows and icons that 
are obscuring other windows and icons, or that are obscured by other windows 
and icons. Secondary windows (i.e. transient windows) are restacked with their 
associated primary window. Secondary windows always stay on top of the associ- 
ated primary window and there can be no other primary windows between the 
secondary windows and their primary window. If an icon function argument is 
specified, then the function applies only to icons. If a window function argument 
is specified then the function applies only to windows. 

flcircle_up [icon | window] 

This function raises the window or icon on the bottom of the window stack (so 
that it is not obscured by any other windows). This function affects only those 
windows and icons that are obscuring other windows and icons, or that are 
obscured by other windows and icons. Secondary windows (i.e. transient win- 
dows) are restacked with their associated primary window. If an icon function 
argument is specified then the function applies only to icons. If an window func- 
tion argument is specified then the function applies only to windows. 

texec or ! 

This function causes command to be executed (using the value of the $SHELL 
environment variable if it is set, otherwise /bin/sh). The ! notation can be used 
in place of the (exec function name. 

£focus_color 

~ This function sets the colormap focus to a client window. If this function is done 
in a root context, then the default colormap (setup by the X Window System for 
the screen where vuewm is running) is installed and there is no specific client 
window colormap focus. This function is treated as //top if colormapFocusPolicy 
is not explicit. 

£focus_k^ 

~ Iliis function sets the keyboard input focus to a client window or icon. This func- 
tion is treated as /nop if keyboardFocusPolicy is not explicit or the function is tix- 
cuted in a root context 
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f.goto workspace 

This function causes the workspace manager to switch to the specified workspace. 
If no workspace exists by the specified name, then no action occurs. 

tkill If the WMDELETEWINDOW protocol is set up, the client is sent a client 
message event indicating that the client window should be deleted. If the 
WM_SAVE_YOURSELF protocol is set up and the WMDELETEWINDOW 
protocol is not set up, the client is sent a client message event indicating that the 
client needs to prepare to be terminated. If the client does not have the 
WM_DELETE_WINDOW or WM SAVEYOURSELF protocol set up, this 
function causes a client's X connection to be terminated (usually resulting in ter- 
mination of the client). Refer to the description of the quUTimeout resource and 
the WMPROTOCOLS property. 

fLIower {client} 

This ftinction lowers a client window to the bottom of the window stack (where it 
obscures no other window). Secondary windows (i.e. transient windows) are res- 
tacked with their associated primary window. The client argument indicates the 
name or class of a client to lower. If the dient argument is not specified then the 
context that the function was invoked in indicates the window or icon to lower. 

flmaximize 

This function causes a client window to be displayed with its maximum size. 

f.inenu This function associates a cascading (pull-right) menu with a menu pane entry or 
a menu with a button or key binding. The menujtame function argument 
identifies the menu to be used. 

flminimize 

This function causes a client window to be minimized (iconified). When a win- 
dow is minimized with no icon box in use, and if the lowerOnlconify resource has 
the value True (the default), the icon is placed on the bottom of the window stack 
(such that it obscures no other window). If an icon box is used, then the client's 
icon changes to its iconified form inside the icon box. Secondary windows (i.e. 
transient windows) are minimized with their associated primary window. There 
is only one icon for a primary window and all its secondary windows. 

flmove This function allows a client window or icon to be moved interactively. 

Unext cmap 

This function installs the next colormap in the list of colormaps for the window 
with the colormap focus. 

flnext key [icon | window | transient] 

This function sets the keyboard input focus to the next window/icon in the set of 
windows/icons managed by the workspace manager (the ordering of this set is 
based on the stacking of windows on the screen). This function is treated as /nop 
likeyboardFocusPolicy is not explicit The keyboard input focus is only mo\«d to 
windows that do not have an associated secondary window that is application 
modal. If the transient argument is specified, then transient (secondary) win- 
dows are traversed (otherwise, if only window is specified, traversal is done only 
to the last focused window in a transient group). If an icon function argument is 
specified, then the function applies only to icons. If a window function argument 
is specified, then the function applies only to windows. 

£next_workspace 

This function causes the workspace manager to switch to the next workspace. If 
you're viewing the last workspace, the switch occurs to the first workspace. 

flnop This function does nothing. 

^normalize 

This function causes a client window to be displayed with its normal size. Secon- 
dary windows (i.e. transient windows) are placed in their normal state along with 
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their associated primary window. 

tnormalize and raise 

Th^ function causes a client window to be displayed with its normal size and 
raised to the top of the window stack. Secondary windows (i.e. transient win- 
dows) are placed in their normal state along with their associated primary win- 
dow. 

floccupy_all 

This function causes the associated window to be placed in all workspaces. 

flpack_icoiis 

This function is used to relayout icons (based on the layout policy being used) on 
the root window or in the icon box. In general this causes icons to be "packed" 
into the icon grid. 

£pass_keys 

This function is used to enable/disable (toggle) processing of key bindings for 
workspace manager functions. When it disables key binding processing all keys 
are passed on to the window with the keyboard input focus and no workspace 
manager functions are invoked. If the f. pass keys function is invoked with a key 
binding to disable key binding processing the same key binding can be used to 
enable key binding processing. 

f.post_wmenu 

This function is used to post the window menu. If a key is used to post the win- 
dow menu and a window menu button is present, the window menu is automati- 
cally placed with its top-left comer at the bottom-left comer of the window menu 
button for the client window. If no window menu button is present, the window 
menu is placed at the top-left comer of the client window. 

flprev_cinap 

This function installs the previous colormap in the list of colormaps for the win- 
dow with the colormap focus. 

flprev_key [icon | window | transient] 

This function sets the keyboard input focus to the previous window/icon in the 
set of windows/icons managed by the workspace manager (the ordering of this 
set is based on the stacking of windows on the screen). This function is treated as 
f.nop if keyboardFocusPolicy is not e]q>licit The keyboard input focus is only 
moved to windows that do not have an associated secondary window that is appli- 
cation modal. If the transient argument is specified, then transient (secondary) 
windows are traversed (otherwise, if only window is specified, traversal is done 
only to the last focused window in a transient group). If an icon function argu- 
ment is specified then the function applies only to icons. If an window function 
argument is specified then the function applies only to windows. 

Uprev workspace 

This function causes the workspace manager to switch to the previous workspace. 
If you're viewing the first workspace, the switch occurs to the last workspace. 

tquit_vuewm 

This function terminates vuewm (but NOT the X window system). 

f.raise [-client] 

This function raises a client window to the top of the window stack (where it is 
obscured by no other window). Secondary windows (i.e. transient windows) are 
restacked with their associated primary window. The client argument indicates 
the name or class of a client to raise. If the client argument is not specified then 
the context that the function was invoked in indicates the window or icon to raise. 

f.raise lower 

~ This function raises a client window to the top of the window stack if it is partially 
obscured by another window, otherwise it lowers the window to the bottom of the 
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window stack. Secondary windows (i.e. transient windows) are restacked with 
their associated primary window. 

^refresh 

This function causes all windows to be redrawn. 

flrefresh_win 

This function causes a client window to be redrawn. 

ilr«nove 

This function causes a client window to be removed from the current workspace. 
If the client window exists only in this workspace, no action will occur. 

fLresize This function allows a client window to be interactively resized. 

trestart 

This function causes vuewm to be restarted (effectively terminated and re- 
executed). 

tsvnijnsg message number 

This function sends a client message of the type MOTIFWMMESSAGES 
with the messagejype indicated by the message jiumber function argument. The 
client message will only be sent if message jiumber is included in the client's 
MOTIFWMMESSAGES property. A menu item label is grayed out if the 
menu item is used to do f.send_msg of a message that is not included in the 
client's MOTIFWMMESSAGES property. 

f.separator 

This function causes a menu separator to be put in the menu pane at the 
specified location (the label is ignored). 

flset_behavior 

This function causes the workspace manager to restart with the default behavior 
(if a custom behavior is configured) or a custom behavior (if a default behavior is 
configured). 

fltitle This function inserts a title in the menu pane at the specified location. 

Utoggle frontpanel 

"This function causes the front panel component of the workspace manager to be 
minimized or, alternately, normalized. 

flversion 

This function causes the workspace manager to display its release version in a 
dialog box. 

£workspace_j)resence 

This function posts the workspace presence dialog box. This allows you to view 
and set the workspace in x^iiich a particular window resides. The root context is 
disallowed for this function. 

flworkspace_reiiame 

This function posts the workspace rename dialog box. This allows you to rename 
the current workspace. 

Each function may be constrained as to which resource types can specify the function 
(e.g., menu pane) and also what context the function can be used in (e.g., the function is 
done to the selected client window). Function contexts are 

root No client window or icon has been selected as an object for the function. 

window A client window has been selected as an object for the function. This 

includes the window's title bar and frame. Some functions are applied 
only when the window is in its normalized state (e.g., f.maximize) or its 
maximized state (e.g., f.nonnalize). 

icon An icon has been selected as an object for the function. 
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If a function is specified in a type of resource where it is not supported or is invoked in a 
context that does not apply then the function is treated as /nop. The following table indi- 
cates the resource types and function contexts in which workspace manager functions 
apply. 



Function 



Contexts 



Resources 



f.actian 

tbeep 

f.circle_down 

tcircle_n> 

f.exec 

fiocus_color 

tfocus_key 

f.goto_woikspace 

fJiiU 

tlower 

f.mairimizp 

Lmenu 

f.minimize 

f.inove 

tnext_cimp 

f.next_k«y 

f.next_woricspace 

f.nop 

f.tnmialize 

f.nonnalize_ancl_raise 

f.oocvqpy_aU 

f.padc_icons 

f.pass_keys 

tpost wmenu 

f.prev_cmap 

tprev_key 

f.prevworkspaoe 

f.quit_vuewm 

f.raise 

f.raise_lower 

Lrefresh 

f.refresh_win 

tTemave 

f.resize 

f.restart 

fsendjmsg 

f.separator 

f.set behavior 

f.title 

f.toggle_ftontpanel 

f.version 

f.workspace_presence 

f.woi1(space_renaine 



rootaorawwiodcmr 
root4oon,wiiidcnr 
rootpooivwindcMr 

root4oon,\nDdow 

root4oon,'wiiido«r 

root^ooivwindowr 

ioot,iooivwinclow 

iam,wia3a» 

ioot^a3a,-modcm 

io(ni,'wiiidoiy(nonnal) 

root^oonAnndcmr 

windonr 

ioon,window 

root,icon,wiiidow 

rootiiooivwindcmr 

rootiicoivwiDdoar 

root40on,windcw 

icon,windCTy(maxinii7.ecl) 

ioon,window 

icon, windonr 

Foot40on,windcmr 

root,ioon,'window 

root,icoiv»indcw 

root,icon,wiiido«r 

root,ioon,wiDdcmr 

root 

root4coii,window 

icoiuwindow 

root4con,window 

windonr 

Foot,icon,window 

window 

root 

icon,window 

root,icon,window 

root,icon,windcmr 

root,ioon,window 

root,ioon,window 

root,ioon,window 

window 

root,icon,windcw 



buttonJ(qr,menu 
bitttoDjuy,n)enu 
biitton4cey,inena 
buttonji^^nenu 
buttonjuyiinenu 
buttonJcey,menu 
buttonJcey,inenu 
biittonJwy,menu 
buttonJcey,inenu 
buttonjcey^nenu 
b\ittonJtey,n)enu 
buttonJci^,menu 
button4wy,menu 
buttonJuy,menu 
buttonJuyAoenu 
buttonJci9,inenu 
buttonjuytinenu 
buttonJc<y,menu 
buttonjKy,menu 
biittonAcey,menu 
bvittonJcey,menu 
buttonjcey^nenu 
buttonJuy,menu 

button4cey,ntenu 

button^cey.menu 

buttonjKy^nenu 

biittonJuy,inenu 

buttonJcey,menu 

button^cey^nenu 

buttonJ{ey,menu 

buttonJcey,iiienu 

biittonJcey,nienu 

buttonJiey,menu 

buttonjcey^nenu 

buttonJcey,menu 

menu 

buttonJcey,nienu 

naenu 

buttonJcey,inenu 

buttonjLey,menu 

buttonjsey^nenu 

buttonJcey,nienu 



WORKSPACE MANAGER EVENT SPECIFICATION 

Events are indicated as part of the specifications for button and key binding sets, and menu panes. 
Button events have the following syntax: 

button = [modifier Jist\<button_event_name> 
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modifier Jist = modifier juane {modifier jiame} 

All modifiers specified are interpreted as being e»;lusive (this means that only the specified 
modifiers can be present when the button event occurs). The following table indicates the values 
that can be used for modifierjtame. The [Alt] key is frequently labeled [Extend] or [Meta]. Alt 
and Meta can be used interchangeably in event specification. 

Modifier Descriptjon 



Qrl 


CbnticdKey 


Shift 


Shift K^ 


Alt 


Alt/Meta Key 


Meta 


Meta/Alt Key 


Lode 


Lode Key 


Modi 


Modifierl 


Mod2 


Modifier2 


Mod3 


Modifiei3 


Mod4 


Modifier4 


Mods 


Modified 



The following table indicates the values that can be used for button jeventjtame. 



Button 



Description 



BtnlDcwn 


Button 1 Press 


BtnlUp 


Button 1 Release 


BtnlOidc 


Button 1 Press and Release 


Btniaidc2 


Button 1 Dotlble Clidc 


Btii2Do«m 


Button 2 Press 


Btn2Up 


Button 2 Release 


BtnaCUdc 


Button 2 Press and Release 


Btii2aidc2 


Button 2 Double Glide 


BtASDosm 


Button 3 Press 


BtnSUp 


Button 3 Release 


BtiiSCUdi 


Button 3 Press and Release 


Btn3Clidc2 


Button 3 Double CUdc 


Btn4Dawn 


Button 4 Press 


Btn4Up 


Button 4 Release 


Btivtaidc 


Button 4 Press and Release 


Btn4aidc2 


Button 4 Double Clidc 


BtnSDcrwn 


Buttons Press 


BtnSUp 


Buttons Release 


BtnSCUdi 


Button S Press and Release 


Btii5CUdt2 


Buttons Double Clidc 



Key events that are used by the workspace manager for menu mnemonics and for binding to 
workspace manager functions are single key presses; key releases are ignored. Key events have 
the following syntax: 

key = [modifier Jist]<Key>key_name 

modifier Jist = modifierjtame {modifierjtame} 

All modifiers specified are interpreted as being exclusive (this means that only the specified 
modifiers can be present when the key event occurs). Modifiers for keys are the same as those 
that apply to buttons. The keyjtame is an Xll keysym name. Keysym names can be found in the 
keysymdef.h file (remove the XK_ prefix). 

BUTTON BINDINGS 

The buttonBindings resource value is the name of a set of button bindings that are used to 
configure workspace manager behavior. A workspace manager function can be done when a but- 
ton press occurs with the pointer over a framed client window, an icon or the root window. The 
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context for indicating where the button press applies is also the context for invoking the workspace 
manager function when the button press is done (significant for functions that are context sensi- 
tive). 

The button binding syntax is 

Buttons bindings _set_name 
{ 

button context junction 

button context function 

button context junction 
} 

The ^ntax for the context specification is 

context = object[\context] 

object = root | icon | window | title | frame | border | app 

The context specification indicates where the pointer must be for the button binding to be 
efifective. For example, a context of window indicates that the pointer must be over a client win- 
dow or window management frame for the button binding to be effective. The frame context is for 
the window management frame around a client window (including the border and titlebar), the 
border context is for the border part of the window management frame (not including the 
titlebar), the title context is for the title area of the window management frame, and the app con- 
text is for the application window (not including the window management frame). 

If an f. nop function is specified for a button binding, the button binding will not be done. 

KEY BINDINGS 

The keyBindings resource value is the name of a set of key bindings that are used to configure 
workspace manager behavior. A window manager function can be done when a particular key is 
pressed. The context in which the key binding applies is indicated in the key binding specification. 
The valid contexts are the same as those that apply to button bindings. 

The key binding syntax is 

Keys bindings jet jiame 
{ 
key context junction 
key context function 

key context junction 
} 

If an f.nop function is specified for a key binding, the key binding will not be done. If an 
f.postjvmenu or f. menu function is bound to a key, vuewm will automatically use the same key for 
removing the menu from the screen after it has been popped up. 

The context specification syntax is the same as for button bindings. For key bindings, the frame, 
title, border, and app contexts are equivalent to the window context. The context for a key event is 
the window or icon that has the keyboard input focus (root if no window or icon has the keyboard 
input focus). 

MENU PANES 

Menus can be popped up using the f.postjvmenu and f.menu workspace manager functions. The 
context for workspace manager functions that are done from a menu is wot, icon or window 
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depending on how the menu was popped up. In the case of the window menu or menus popped 
up with a key binding, the location of the keyboard input focus indicates the context For menus 
popped up using a button binding, the context of the button binding is the context of the menu. 

The menu pane specification syntax is 
Menu menujuane 

{ 

label Mnemonic] [accelerator] Junction 
label [mnemonic] [accelerator] function 



label [mnemonic] [accelerator] function 
} 

Each line in the Menu specification identifies the label for a menu item and the function to be 
done if the menu item is selected. Optionally a menu button mnemonic and a menu button key- 
board accelerator maybe specified. Mnemonics are functional onlyii^en the menu is posted and 
keyboard traversal applies. 

The label may be a string or a bitmap file. The label specification has the following syntax: 

label = text \ bitmap Jile 

bitmap_file = @file name 

text = quoted Jtem \ unquoted Jtem 

The string encoding for labels must be compatible with the menu font that is used. Labels are 
greyed out for menu items that do the f.nop function or an invalid function or a function that 
doesn't apply in the current context. 

A mnemonic specification has the following syntax 

mnemonic = _character 

The first matching character in the label is underlined. If there is no matching character in the 
label, no mnemonic is registered with the workspace manager for that label. Although the charac- 
ter must exactly match a character in the label, the mnemonic will not execute if any modifier (such 
as Shift) is pressed with the character key. 

The accelerator specification is a key event specification with the same syntax as is used for key 
bindings to workspace manager functions. 

FRONT PANEL CONTENT AND LAYOUT 

The resource description file enables you to specify the content and layout of the fixint panel, 
including the number of controls, their size and arrangment within the front panel, and their 
operation. 

The layout is arranged horizontally, in terms of rows of controls. 

The front panel specification syntax is demonstrated in the sys.vuewmrc system file included in the 
/usr/lib/Xll/vue/Vuewm directory. 

ERRORS 

Errors that occur as a result of parsing or trying to use the resource description file will be 
reported to a log file under your home directory: $HOME/.vue/errorlog. Be sure to check this 
text file if the appearance or behavior of vuewm is not what you ejq)ect. 

FILES 

$HOME/.vue/$LANG/vuewmrc 
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$HOME/.vue/vuewmrc 

/usr/lib/Xll/vue/Vuewxn/$LANG/sys.vuewmrc 
/usr/lib/Xl 1/vue/ Vuewm/sys.vuewmrc 
$HOME/.vue/errorlog 

COPYMGHT 

(c) Copyright 1989, 1990 by Open Software Foundation, Inc. 

(c) Copyright 1987, 1988, 1989, 1990 by Hewlett-Packard Company 

All rights reserved. 

AUTHOR 

The OSF/HP Motif Window Manager and the Hevdett-Packard Visual User Environment Win- 
dow Manager were developed by HP. 

ORIGIN 

Hewlett-Packard Company ITO 

SEE ALSO 

vuewm(lX) and X(l). 
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NAME 

xload - load average display for X 

SYNOPSIS 

xload [-toolkitoption ...] [-scale integef\ [-update seconds] [-hi color\ [-highlight color] 
[-jumpscroll pixels] [-label string\ [-nolabel] 

DESCRIPTION 

The xload program displays a periodically updating histogram of the system load average. 

OPTIONS 

Xload accepts all of the standard X Toolkit command line options (see Xil))- The order of the 
options in unimportant. Xload also accepts the following additional options: 

-hi color or -highlight color 

This option specifies the color of the scale lines. 

-jumpscroll number of pixels 

The number of pixels to shift the graph to the left when the graph reaches the right edge 
of the window. The default value is 1/2 the width of the current window. Smooth scrol- 
ling can be achieved by setting it to 1. 

•label string 

The string to put into the label above the load average. 

-nolabel If this command line option is specified then no label will be displayed above the load 
graph. 

-scale integer 

This option specifies the minimum number of tick marks in the histogram, where one 
division represents one load average point. If the load goes above this number, xload 
will create more divisions, but it will never use fewer than this number. The default is 1. 

■vpdate seconds 

This option specifies the frequency in seconds at which xload updates its display. The 
minimum amount of time allowed between updates is 1 second (the default is S seconds). 

RESOURCES 

In addition to the resources available to each of the widgets used by xload there is one resource 
defined by the application itself. 

showLabel (class Boolean) 

If False then no label will be displayed. 

WIDGETS 

In order to specify resources, it is useful to know the hierarchy of the widgets which compose 
xload. In the notation below, indentation indicates hierarchical structure. The widget class name 
is given first, followed by the widget instance name. 

XLoad xload 

Paned paned 

Label label 
StripChart load 

ENVIRONMENT 

DISPIAY 

The default host and display number. 

XENVIRONMENT 

The name of a resource file that overrides the global resources stored in the 
RESOURCEMANAGER property. 

FILES 

/usr/lib/Xll/app-defaults/XLoad - specifies required resources 
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SEE ALSO 

X(l), xrdb(l), mem(4), Athena StripChart Widget. 

BUGS 

This program requires the ability to open and read the special system file /dev/kmem. Sites that 
do not allow general access to this file should make xload belong to the same group as /dev/kmem 
and turn on the set gfoup id permission flag. 

Reading /dev/kmem is inherently non-portable. Therefore, the routine used to read it 
(getjoad.c) must be ported to each new operating system. 

COPYRIGHT 

Copyright 1988, Massachusetts Institute of Technology. 
See X{1) for a full statement of rights and permissions. 

AUTHORS 

K. Shane Hartman (MIT-LCS) and Stuart A. Malone (MIT-LCS); 

with features added by Jim Gettys (MIT-Athena), Bob Scheifler (MIT-LCS), Tony Delia Fera 

(MIT-Athena), and Chris Peterson (MIT-LCS). 
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NAME 

xterm - terminal emulator for X 

SYNOPSIS 

xterm [-toolkitoption] [-option] 

DESCRIPTION 

The xterm program is a terminal emulator for the X Window System. It provides DEC Vn02 and 
Tektronix 4014 compatible terminals for programs that can't use the window system directly. If the 
underlying operating system supports terminal resizing capabilities (for example, the SIGWINCH 
signal in systems derived from 4.3bsd), xterm will use the facilities to notify programs running in 
the window whenever it is resized. 

The VT102 and Tektronix 4014 terminals each have their own window so that you can edit text in 
one and look at graphics in the other at the same time. To maintain the correct aspect ratio 
(height/width), Tektronix graphics will be restricted to the largest box with a 4014's aspect ratio 
that will fit in the window. This box is located in the upper left area of the window. 

Although both windows maybe displayed at the same time, one of them is considered the "active" 
window for receiving keyboard input and terminal output This is the window that contains the 
text cursor and whose border highlights whenever the pointer is in either window. The active win- 
dow can be chosen through escape sequences, the "Modes" menu in the VT102 window, and the 
"Tektronix" menu in the 4014 window. 

OPTIONS 

The xterm terminal emulator accepts all of the standard X Toolkit command line options as well as 
the following (if the option begins with a '+' instead of a '-', the option is restored to its default 
value): 

-help This causes xterm to print out a verbose message describing its options. 

-132 Normally, the VT102 DECCOLM escape sequence that switches between 80 and 132 
column mode is ignored. This option causes the DECCOLM escape sequence to be 
recognized, and the xtemt window will resize appropriately. 

-ah This option indicates that xterm should always highlight the text cursor and borders. By 

default, xterm will display a hollow text cursor whenever the focus is lost or the pointer 
leaves the window. 

+ah This option indicates that xterm should do text cursor highlighting. 

-b number 

This option specifies the size of the inner border (the distance between the outer edge of 
the characters and the window border) in pixels. The default is 2. 

-cc characterclassrangewaluel^] 

This sets classes indicated by the given ranges for using in selecting by words. See the 
section specifying character classes. 

-en This option indicates that newlines should not be cut in line-mode selections. 

+CI1 This option indicates that newlines should be cut in line-mode selections. 

-cr color This option specifies the color to use for text cursor. The default is to use the same fore- 
ground color that is used for text. 

•cu This option indicates that xterm should work around a bug in the oases (3x) cursor 

motion package that causes the more(l) program to display lines that are exactly the 
width of the window and are followed by a line beginning with a tab to be displayed 
incorrectly (the leading tabs are not displayed). 

+CU This option indicates that that xterm should not work around the curses (3x) bug men- 
tioned above. 

-eproff-am [arguments ...] 

This option specifies the program (and its command line arguments) to be run in the 
xterm window. It also sets the window title and icon name to be the basename of the 
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program being ei^cuted if neither -T nor -n are given on the command line. This must 
be the last option on the command line. 

4b font This option specifies a font to be used \«^en displaying bold text This font must be the 
same height and width as the normal font If only one of the normal or bold fonts is 
specified, it will be used as the normal font and the bold font will be produced by over- 
striking this font The default is to do overstriking of the normal font 

-j This option indicates that xterm should do jump scrolling. Normally, text is scrolled one 

line at a time; this option allows xterm to move multiple lines at a time so that it doesn't 
fall as far behind. Its use is strongly recommended since it make xterm much faster when 
scanning through large amounts of text The VTIOO escape sequences for enabling and 
disabling smooth scroll as well as the "Modes" menu can be used to turn this feature on 
or off. 

+ j This option indicates that xterm should not do jump scrolling. 

-1 This option indicates that xterm should send all terminal output to a log file as well as to 

the screen. This option can be enabled or disabled using the "xterm Xll" menu. 

+1 This option indicates that xterm should not do logging. 

'U filename 

This option specifies the name of the file to which the output log described above is writ- 
ten. If /(7e begins with a pipe symbol (|), the rest of the string is assumed to be a com- 
mand to be used as the endpoint of a pipe. The default filename is "XtermiLogJOOOCX" 
(where XXXXX is the process id of xterm) and is created in the directory from which 
xterm was started (or the user's home directory in the case of a login window). 

-Is This option indicates that the shell that is started in the xterm window be a login shell 

(i.e. the first character of argvfO] will be a dash, indicating to the shell that it should read 
the user's .login or .profile). 

■I- Is This option indicates that the shell that is started should not be a login shell (i.e. it will 
be a normal "subshell"). 

-mb This option indicates that xterm should ring a margin bell when the user types near the 
right end of a line. This option can be turned on and off from the "Modes" menu. 

4-mb This option indicates that margin bell should not be rung. 

-mc milliseconds 

This option specifies the maximum time between multi-click selections. 

-ms color 

This option specifies the color to be used for the pointer cursor. The default is to use 
the foreground color. 

-nb number 

This option specifies the number of characters from the right end of a line at which the 
margin bell, if enabled, will ring. The default is 10. 

-rw This option indicates that reverse-wraparound should be allowed. This allows the cursor 

to back up from the leftmost column of one line to the rightmost column 9f the previous 
line. This is very useful for editing long shell command lines and is encouraged. This 
option can be turned on and off from the "Modes" menu. 

+rw This option indicates that reverse-wraparound should not be allowed. 

•aw This option indicates that auto-wraparound should be allowed. This allows the cursor to 
automatically wrap to the beginning of the next line when when it is at the rightmost 
position of a line and text is output 

+aw This option indicates that auto-wraparound should not be allowed. 

-s This option indicates that xterm may scroll asynchronously, meaning that the screen does 

not have to be kept completely up to date while scrolling. This allows jtfcmj to run faster 
when network latencies are very high and is typically useful when running across a very 
large internet or many gateways. 
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+ s This option indicates that xterm should scroll synchronously. 

-sb This option indicates that some number of lines that are scrolled o£F the top of the win- 

dow should be saved and that a scrollbar should be displayed so that those lines can be 
viewed. This option may be turned on and off from the "Modes" menu. 

+ sb This option indicates that a scrollbar should not be displayed. 

-sf This option indicates that Sun Function Key escape codes should be generated for func- 

tion keys. 

+ sf This option indicates that the standard escape codes should be generated for function 
keys. 

•si This option indicates that output to a window should not automatically reposition the 

screen to the bottom of the scrolling region. This option can be turned on and off from 
the "Modes" menu. 

+ si This option indicates that output to a window should cause it to scroll to the bottom. 

-sk This option indicates that pressing a key while using the scrollbar to review previous 

lines of text should cause the window to be repositioned automatically in the normal 
position at the bottom of the scroll region. 

+ sk This option indicates that pressing a key while using the scrollbar should not cause the 
window to be repositioned. 

-si number 

This option specifies the number of lines to save that have been scrolled off the top of 
the screen. The default is 64. 

-t This option indicates that xterm should start in Tektronix mode, rather than in VT102 

mode. Switching between the two windows is done using the "Modes" menus. 

+t This option indicates that xterm should start in VT102 mode. 

-tm string 

This option specifies a series of terminal setting keywords followed by the characters that 
should be bound to those functions, similar to the stty program. Allowable keywords 
include: intr, quit, erase, kill, eof, eol, swtch, start, stop, brk, susp, dsusp, rpmt, flush, 
weras, and Inext. Control characters may be specified as ^char (e.g. "^c or '^u) and ^? 
maybe used to indicate delete. 

An name 

This option specifies the name of the terminal type to be set in the TERM environment 
variable. This terminal type must exist in the termcap(S) database and should have //# 
and co# entries. 

-ut This option indicates that xtetm shouldn't write a record into the the system log file 

/etc/utmp. 

+ut This option indicates that xterm should write a record into the system log file /etc/utmp. 

-vb This option indicates that a visual bell is preferred over an audible one. Instead of ring- 

ing the terminal bell whenever a Control-G is received, the window will be flashed. 

+vb This option indicates that a visual bell should not be used. 

-wf This option indicates that xterm should wait for the window to be mapped the first time 

before starting the subprocess so that the initial terminal size settings and environment 
variables are correct. It is the application's responsibility to catch subsequent terminal 
size changes. 

+ wf This option indicates that xterm show not wait before starting the subprocess. 

-C This option indicates that this window should receive console output. This is not sup- 

ported on all systems. 

-Seen This option specifies the last two letters of the name of a pseudoterminal to use in slave 
mode, plus the number of the inherited file descriptor. The option is parsed ''%c%c%d". 
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This allows x^emt to be used as an input and output channel for an existing program and 
is sometimes used in specialized applications. 

The following command line arguments are provided for compatibility with older versions. They 
may not be supported in the next release as the X Toolkit provides standard options that accom- 
plish the same task. 

%geom This option specifies the preferred size and position of the Tektronix window. It is 
shorthand for specifying the ''*tekGeometty'' resource. 

4tgeom This option specifies the preferred position of the icon window. It is shorthand for 
specifying the ''*iconGeometiy* resource. 

-T string This option specifies the title foTxteim's windows. It is equivalent to -title. 

-n string This option specifies the icon name fotxtenn^s windows. It is shorthand for specifying 
the "*iconName'' resource. Note that this is not the same as the toolkit option -name 
(see below). The default icon name is the application name. 

-r This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. It is equivalent to -reversevideo or -rv. 

■w number 

This option specifies the width in pixels of the border surrounding the window. It is 
equivalent to 4>orderwidth or -bw. 

The following standard X Toolkit command line arguments are commonly used with xterm: 

-bg color 

This option specifies the color to use for the background of the window. The default is 
"white." 

-bd color 

This option specifies the color to use for the border of the window. The default is 
"black." 

-bw number 

This option specifies the width in pixels of the border surrounding the window. 

-tg color This option specifies the color to use for displaying text. The default is "black". 

-fn font This option specifies the font to be used for displaying normal text. The default is fixed. 

-name name 

This option specifies the application name under which resources are to be obtained, 
rather than the default executable file name. Name should not contain "." or "*" charac- 
ters. 

-title string 

This option specifies the window title string, which may be displayed by window 
managers if the user so chooses. The default title is the command line specified after the 
-e option, if any, otherwise the application name. 

-rv This option indicates that reverse video should be simulated by swapping the foreground 

and background colors. 

-geometry geometry 

ITiis option specifies the preferred size and position of the VT102 windovi^ see XiT). 

•display displc^ 

This option specifies the X server to contact; see X(l). 

-xrm resourcestring 

This option specifies a resource string to be used. This is especially useful for setting 
resources that do not have separate command line options. 

-iconic This option indicates that xterm should ask the window manager to start it as an icon 
rather than as the normal window. 
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RESOURCES 

The program understands all of the core X Toolkit resource names and classes as well as: 

iconGeometry (class IconGeometiy) 

Specifies the preferred size and position of the application when iconified. It is not 
necessarily obeyed by all window managers. 

temiName (class TemiName) 

Specifies the terminal type name to be set in the TERM environment variable. 

title (class Title) 

Specifies a string that may be used by the window manager A^en displaying this applica- 
tion. 

ttyModes (class TtyModes) 

Specifies a string containing terminal setting keywords and the characters to vdiich they 
may be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, swtch, start, 
stop, brk, susp, dsusp, rpmt, flush, weras, and Inext. Control characters may be specified 
as ^char (e.g. "^c or ^u) and '^? may be used to indicate delete. This is very useful for 
overriding the default terminal settings without having to do an stty every time an xterm is 
started. 

utmplnhibit (class Utmplnhibit) 

Specifies whether or not xterm should try to record the user's terminal in /etc/utmp. 

sunf^nctionK^s (class SunFunctionKeys) 

Specifies whether or not Sun Function Key escape codes should be generated for func- 
tion keys instead of standard escape sequences. 

The following resources are specified as part of the vtlOO widget (class VTIOO): 

allowSendEvents (class AUowSendEvents) 

Specifies whether or not synthetic key and button events (generated using the X protocol 
SendEvent request) should be interpreted or discarded. The default is "false" meaning 
they are discarded. Note that allowing such events creates a very large security hole. 

ahvaysHighlight (class AIwaysHighlight) 

Specifies whether or not xterm should always display a highlighted text cursor. By 
default, a hollow text cursor is displayed whenever the pointer moves out of the window 
or the window loses the input focus. 

boldFont (class Font) 

Specifies the name of the bold font to use instead of overstriking. 

cl32 (class C132) 

Specifies whether or not the VT102 DECCOLM escape sequence should be honored. 
The default is "false." 

charClass (class CharClass) 

Specifies comma-separated lists of character class bindings of the form [low-yti^:value. 
These are used in determining which sets of characters should be treated the same when 
doing cut and paste. See the section on specifying character classes. 

curses (class Curses) 

Specifies v^ether or not the last column bug in curses (3x) should be worked around. 
The default is "false." 

background (class Background) 

Specifies the color to use for the background of the window. The default is "white." 

foreground (class Foreground) 

Specifies the color to use for displaying text in the window. Setting the class name 
instead of the instance name is an easy way to have everything that would normally 
appear in the "text" color change color, llie default is "black." 
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cursorCoIor (class Foreground) 

Specifies the color to use for the text cursor. The default is "black." 

eightBUInput (class EightBitlnput) 

Specifies how a character input from the keyboard via the action, insert-eight-bit() is 
modified (insert-eiglit-bit() is normally bound to Meta<Keji*ress>). If "true", the char- 
acter always has its high bit set on. If "false", ESC is prepended to the character without 
modifying it. The default is "true." 

eightBitOutput (class EightBitOutput) 

Specifies whether or not eight-bit characters sent from the host should be accepted as is 
or stripped when printed. The default is "true." 

font (class Font) 

Specifies the name of the normal font. The default is "fixed." 

fontl (class Fontl) 

Specifies the name of the first alternate font 

font2 (class Font2) 

Specifies the name of the second alternate font 

font3 (class Font3) 

Specifies the name of the third alternate font 

font4 (class Font4) 

Specifies the name of the fourth alternate font 

geometry (class Geometi;y) 

Specifies the preferred size and position of the VT102 window. 

intemalBorder (class Border\^ldth) 

Specifies the number of pixels between the characters and the window border. The 
default is 2. 

jumpScroll (class JumpScroU) 

Specifies whether or not jump scroll should be used. The default is "true". 

logFile (class Ix^file) 

Specifies the name of the file to which a terminal session is logged. The default is 
"XtermLogXQXX" (where AXXXy is the process id of xterm). 

logging (class Lt^ging) 

Specifies whether or not a terminal session should be logged. The default is "false." 

loglnhibit (class Loglnhibit) 

Specifies whether or not terminal session logging should be inhibited. The default is 
"false." 

loginShell (class L4>guiSheIl) 

Specifies whether or not the shell to be run in the window should be started as a login 
shell. The default is "false." 

mai^inBell (class MarginBell) 

Specifies whether or not the bell should be run when the user types near the right mar- 
gin. The default is "false." 

multiScroU (class MultiScroIl) 

Specifies whether or not asynchronous scrolling is allowed. The default is "false." 

multiClickTime (class MultiClickTime) 

Specifies the maximum time in milliseconds between multi-clock select events. The 
default is 250 milliseconds. 

multiScroIl (class MultiScroU) 

Specifies whether or not scrolling should be done asynchronously. The default is "false." 

nMarginBell (class Column) 

Specifies the number of characters from the right margin at which the margin bell should 
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be run, vdien enabled. 

pointerColor (class Foreground) 

Specifies the foreground color of the pointer. The default is "XtDefaultForeground." 

pointerCoIorBackground (class Background) 

Specifies the background color of the pointer. The default is "XtDefaultBackground." 

pointerShape (class Cursor) 

Specifies the name of the shape of the pointer. The default is "xterm." 

reverseVideo (class ReverseVideo) 

Specifies whether or not reverse video should be simulated. The default is "false." 

reverseWrap (class ReverseWrap) 

Specifies whether or not reverse-wraparound should be enabled. The default is "false." 

autoWrap (class AutoWrap) 

Specifies whether or not auto-wraparound should be enabled. The default is "true." 

saveLines (class SaveLines) 

Specifies the number of lines to save beyond the top of the screen ^en a scrollbar is 
turned on. The default is 64. 

scrolIBar (class ScroUBar) 

Specifies whether or not the scrollbar should be displayed. The default is "false." 

scroUTtyOutput (class ScroUCond) 

Specifies whether or not output to the terminal should automatically cause the scrollbar 
to go to the bottom of the scrolling region. The default is "true." 

scrollK^ (class ScroIICond) 

Specifies whether or not pressing a key should automatically cause the scrollbar to go to 
the bottom of the scrolling region. The default is "false." 

scroULines (class ScrolILines) 

Specifies the number of lines that the scroll-back and scroll-fonv actions should use as a 
default. The default value is 1. 

signallnhibit (class Signallnhibit) 

Specifies whether or not the entries in the "xterm Xll" menu for sending signals to 
xterm should be disallowed. The default is "false." 

tekGeometry (class Geometry) 

Specifies the preferred size and position of the Tektronix window. 

teklnhibit (class Teklnhibit) 

Specifies whether or not Tektronix mode should be disallowed. The default is "false." 

tekSmall (class TekSmall) 

Specifies whether or not the Tektronix mode window should start in its smallest size if no 
e^licit geometry is given. This is useful \^en running xtemt on displays with small 
screens. The default is "false." 

tekStartup (class TekStartup) 

Specifies whether or not xterm should start up in Tektronix mode. The default is "false." 

titelnhibit (class Titelnhibit) 

Specifies whether or not xterm should remove remove ti or te termcap entries (used to 
switch between alternate screens on startup of many screen-oriented programs) from the 
TERMCAP string. 

translations (class Translations) 

Specifies the key and button bindings for menus, selections, "programmed strings", etc. 
See ACTIONS below. 

visualBell (class VisualBell) 

Specifies whether or not a visible bell (i.e. flashing) should be used instead of an audible 
bell when Control-G is received. The default is "false." 
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waitForMap (class WaitForMap) 

Specifies v^liether or not xteim should wait for the initial window map before starting the 
subprocess. The default is "false." 

The following resources are specified as part of the tek4014 widget (class Tek4014): 

width (class \^dth) 

Specifies the width of the Tektronix window in pixels. 

height (class Height) 

Specifies the height of the Tektronix window in pixels. 

fontLarge (class Font) 

Specifies the large font to use in the Tektronix window. 

font2 (class Font) 

Specifies font number 2 to use in the Tektronix window. 

font3 (class Font) 

Specifies font number 2 font to use in the Tektronix window. 

fontSmall (class Font) 

Specifies the small font to use in the Tektronix window. 

The resources that maybe specified for the various menus are described in the documentation for 
the Athena SimpleMenu widget. The name and classes of the entries in each of the menus are 
listed below. 

The mainMenu has the following entries: 

securekbd (class SmeBSB) 

This entry invokes the secure() action. 

allowsends (class SmeBSB) 

This entry invokes the allow-send-events(toggle) action. 

loggii^ (class SmeBSB) 

This entry invokes the set-l(^ing(toggIe) action. 

redraw (class SmeBSB) 

This entry invokes the redraw() action. 

linel (class SmeLine) 

This is a separator. 

suspend (class SmeBSB) 

This entry invokes the send-signal(suspend) action on systems that support job control. 

continue (class SmeBSB) 

This entry invokes the send-signal(cont) action on systems that support job control. 

interrupt (class SmeBSB) 

This entry invokes the send-signal(int) action. 

hangup (class SmeBSB) 

This entry invokes the send-signal(hup) action. 

terminate (class SmeBSB) 

Iliis entry invokes the send-signal(term) action. 

kiU (class SmeBSB) 

This entry invokes the send-signal(kill) action. 

Iine2 (class SmeLine) 

This is a separator. 

quit (class SmeBSB) 

This entry invokes the quit() action. 
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The vtMenu has the following entries: 

scrollbar (class SmeBSB) 

This entry invokes the set-scrollbar(toggle) action. 

jumpscroll (class SmeBSB) 

This entry invokes the set-jumpscroll(toggle) action. 

reversevideo (class SmeBSB) 

This entry invokes the set-reverse-video(toggle) action. 

autowrap (class SmeBSB) 

This entry invokes the set-autowrap(toggle) action. 

reversewrap (class SmeBSB) 

liiis entry invokes the set-reversewrap(toggle) action. 

autolinefeed (class SmeBSB) 

This entry invokes the set-autoliiiefeed(toggle) action. 

appcursor (class SmeBSB) 

This entry invokes the set-appcursor(toggle) action. 

appk^pad (class SmeBSB) 

This entry invokes the set-appke^ad(toggle) action. 

scroUkey (class SmeBSB) 

This entry invokes the set-scroll-on-key(toggle) action. 

scrollttyoutput (class SmeBSB) 

This entry invokes the set-scroll-on-tty-output(toggle) action. 

alIowl32 (class SmeBSB) 

This entry invokes the set-allowl32(toggle) action. 

cursesemul (class SmeBSB) 

This entry invokes the set-€ursesemul(toggle) action. 

visualbell (class SmeBSB) 

This entry invokes the set-visualbell(toggle) action. 

marginbell (class SmeBSB) 

This entry invokes the set-marginbell(toggle) action. 

altscreen (class SmeBSB) 

This entry is currently disabled. 

linel (class SmeLine) 

This is a separator. 

softreset (class SmeBSB) 

This entry invokes the soft-reset() action. 

hardreset (class SmeBSB) 

This entry invokes the hard-reset() action. 

Iine2 (class SmeLine) 

This is a separator. 

tekshow (class SmeBSB) 

This entry invokes the set-visibility(tek,toggle) action. 

tekmode (class SmeBSB) 

This entry invokes the set4erminal-type(tek) action. 

vthide (class SmeBSB) 

This entry invokes the set-visibility(vt,off) action. 



The fontMenu has the following entries: 
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fontdefault (class SmeBSB) 

This entry invokes the set-vt-font(d) action. 

fontl (class SmeBSB) 

This entry invokes the set-vt-font(l) action. 

font2 (class SmeBSB) 

This entry invokes the set-vt-font(2) action. 

fonta (class SmeBSB) 

This entry invokes the set-vt-foiit(3) action. 

font4 (class SmeBSB) 

This entry invokes the set-vt-font(4) action. 

fontescape (class SmeBSB) 

This entry invokes the set-vt-font(e) action. 

fontsel (class SmeBSB) 

This entry invokes the set-vt-font(s) action. 

The tekMenu has the following entries: 

tektextlarge (class SmeBSB) 

This entry invokes the set-tek-text(l) action. 

tektext2 (class SmeBSB) 

This entry invokes the set4ek-text(2) action. 

tektexta (class SmeBSB) 

This entry invokes the set-tek-text(3) action. 

tektextsmall (class SmeBSB) 

This entry invokes the set-tek-text(s) action. 

linel (class SmeLine) 

This is a separator. 

telq>age (class SmeBSB) 

This entry invokes the tek-page() action. 

tekreset (class SmeBSB) 

This entry invokes the tek-reset() action. 

tekcopy (class SmeBSB) 

This entry invokes the tek-copy() action. 

Iine2 (class SmeLine) 

This is a separator. 

vtshow (class SmeBSB) 

This entry invokes the set-visibility(vt,toggle) action. 

vtmode (class SmeBSB) 

This entry invokes the set-tenninal4ype(vt) action. 

tekhide (class SmeBSB) 

This entry invokes the set-visibility(tek,toggIe) action. 

The following resources are useful when specified for the Athena Scrollbar widget: 

thickness (class Thickness) 

Specifies the width in pixels of the scrollbar. 

background (class Background) 

Specifies the color to use for the background of the scrollbar. 

for^round (class Foreground) 

Specifies the color to use for the foreground of the scrollbar. The "thumb" of the 
scrollbar is a simple checkerboard pattern alternating pixels for foreground and 
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background color. 

EMULATIONS 

The VT102 emulation is fairly complete, but does not support the blinking character attribute nor 
the double-wide and double-size character sets. Termcap(5) entries that work with xterm include 
"xterm", "vtl02", 'VtlOO" and "ansi", and xterm automatically searches the termcap file in this 
order for these entries and then sets the "TERM" and the 'TERMCAP" environment variables. 

Many of the special xterm features (like logging) may be modified under program control through 
a set of escape sequences different from the standard Vn02 escape sequences. (See the "Xterm 
Control Sequences" document.) 

The Tektronix 4014 emulation is also fairly good. Four different font sizes and five different lines 
types are supported. The Tektronix text and graphics commands are recorded internally by x^emt 
and may be written to a file by sending the COPY escape sequence (or through the Tektronix 
menu; see below). The name of the file will be "COVYyy-MM-ddJthvnmiss", where yy, MM, dd, 
hh, mm and ss are the year, month, day, hour, minute and second when the COPY was performed 
(the file is created in the directory xTcttm is started in, or the home directory for a login xterm). 

POINTER USAGE 

Once the VT102 window is created, xterm allows you to select text and copy it within the same or 
other windows. 

The selection functions are invoked when the pointer buttons are used with no modifiers, and 
when they are used with the "shift" key. The assignment of the functions described below to keys 
and buttons may be changed through the resource database; see ACTIONS below. 

Pointer button one (usually left) is used to save text into the cut buffer. Move the cursor to begin- 
ning of the text, and then hold the button down while moving the cursor to the end of the region 
and releasing the button. The selected text is highlighted and is saved in the global cut buffer and 
made the PRIMARY selection when the button is released. Double-clicking selects by words. 
Triple-clicking selects by lines. Quadruple-clicking goes back to characters, etc. Multiple-click is 
determined by the time from button up to button down, so )rou can change the selection unit in the 
middle of a selection. If the key/button bindings specify that an X selection is to be made, xterm 
will leave the selected text highlighted for as long as it is the selection owner. 

Pointer button two (usually middle) 'types' (pastes) the text from the PRIMARY selection, if any, 
otherwise from the cut buffer, inserting it as keyboard input. 

Pointer button three (usually right) extends the current selection. (Without loss of generality, that 
is you can swap "rigjit" and "left" everywhere in the rest of this paragraph...) If pressed while 
closer to the right edge of the selection than the left, it extends/contracts the right edge of the 
selection. If you contract the selection past the left edge of the selection, xterm assumes you really 
meant the left edge, restores the original selection, then extends/contracts the left edge of the 
selection. Extension starts in the selection unit mode that the last selection or extension was per- 
formed in; you can multiple-click to cycle through them. 

By cutting and pasting pieces of text without trailing new lines, you can take text from several 
places in different windows and form a command to the shell, for example, or take output from a 
program and insert it into your favorite editor. Since the cut buffer is g;lobally shared among 
different applications, you should regard it as a 'file' whose contents you know. The terminal 
emulator and other text programs should be treating it as if it were a text file, i.e. the text is delim- 
ited by new lines. 

The scroll region displays the position and amount of text currently showing in the window 
(highlighted) relative to the amount of text actually saved. As more text is saved (up to the max- 
imum), the size of the highlighted area decreases. 

Clicking button one with the pointer in the scroll region moves the adjacent line to the top of the 
display window. 

Clicking button three moves the top line of the display window down to the pointer position. 

Clicking button two moves the display to a position in the saved text that corresponds to the 
pointer's position in the scrollbar. 
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Unlike the Vn02 window, the Tektronix window dows not allow the copying of text. It does allow 
Tektronix GIN mode, and in this mode the cursor will change from an arrow to a cross. Pressing 
any key will send that key and the current coordinate of the cross cursor. Pressing button one, 
two, or three will return the letters '1', 'm', and V, respectively. If the 'shift' key is pressed vtiien a 
pointer button is pressed, the corresponding upper case letter is sent To distinguish a pointer 
button from a key, the high bit of the character is set (but this is bit is normally stripped unless the 
terminal mode is RAW; see tty(4) for details). 

MENUS 

Xterm has four menus, named mainMenu, vtMemt, fontMenu, and tekMenu. Each menu pops up 
under the correct combinations of key and button presses. Most menus are divided into two sec- 
tion, separated by a horizontal line. The top portion contains various modes that can be altered. 
A check mark appears next to a mode that is currently active. Selecting one of these modes tog- 
gles its state. The bottom portion of the menu are command entries; selecting one of these per- 
forms the indicated function. 

The xterm menu pops up when the "control" key and pointer button one are pressed in a window. 
The mainMenu contains items that apply to both the VT102 and Tektronix windows. The Secure 
Kq^ard mode is be used when typing in passwords or other sensitive data in an unsecure 
environment; see SECURTIY below. Notable entries in the command section of the menu are the 
Continue, Suspend, Interrupt, Hangup, Terminate and Kill which sends the SIGCOMT, SIGTSTP, 
SIGINT, SIGHUP, SIGTERM and SIGKILL signals, respectively, to the process group of the pro- 
cess running under x^emt (usually the shell). The Continue function is especially useful if the user 
has accidentally typed CTRL-Z, suspending the process. 

The vtMenu sets various modes in the VT102 emulation, and is popped up when the "control" key 
and pointer button two are pressed in the VT102 window. In the command section of this menu, 
the soft reset entry will reset scroll regions. This can be convenient when some program has left 
the scroll regions set incorrectly (often a problem when using VMS or TOPS-20). The full reset 
entry will clear the screen, reset tabs to every eight columns, and reset the terminal modes (such as 
wrap and smooth scroll) to their initial states just after xtemt has finished processing the command 
line options. 

The fontMenu sets the font used in the VT102 window. 

The tekMenu sets various modes in the Tektronix emulation, and is popped up when the "control" 
key and pointer button two are pressed in the Tektronix window. The current font size is checked 
in the modes section of the menu. The PAGE entry in the command section clears the Tektronix 
window. 

SECURITY 

X environments dififer in their security consciousness. MIT servers, run under x^m, are capable of 
using a "magic cookie" authorization scheme that can provide a reasonable level of security for 
many people. If your server is only using a host-based mechanism to control access to the server 
(see xhost(l)), then if you enable access for a host and other users are also permitted to run 
clients on that same host, there is every possibility that someone can run an application that will 
use the basic services of the X protocol to snoop on your activities, potentially capturing a tran- 
script of everything you type at the keyboard. This is of particular concern when you want to type 
in a password or other sensitive data. The best solution to this problem is to use a better authori- 
zation mechanism that host-based control, but a simple mechanism exists for protecting keyboard 
input in xterm. 

The xterm menu (see MENUS above) contains a Secure Keyboard entry which, when enabled, 
ensures that all keyboard input is directed onfy to :Uerm (using the GrabKeyboard protocol 
request). When an application prompts you for a password (or other sensitive data), you can 
enable Secure K^board using the menu, type in the data, and then disable Secure Keyboard using 
the menu again. Only one X client at a time can secure the keyboard, so when you attempt to 
enable Secure Kqitoard it may fail. In this case, the bell will sound. If the Secure Kqi)oard 
succeeds, the foreground and background colors will be exchanged (as if you selected the Reverse 
Video entry in the Modes menu); they will be e»;hanged a^in when you exit secure mode. If the 
colors do not switch, then you should be very suspicious that you are being spoofed. If the applica- 
tion you are running displays a prompt before asking for the password, it is safest to enter secure 
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mode before the prompt gets displayed, and to make sure that the prompt gets displayed correctly 
(in the new colors), to minimize the probability^ of spoofing. You can also bring up the menu 
again and make sure that a check mark appears next to the entry. 

Secure Ke^ard mode will be disabled automatically if your xterm window becomes iconifled (or 
otherwise unmapped), or if you start up a reparenting window manager (that places a title bar or 
other decoration around the window) while in Secure K^board mode. (This is a feature of the X 
protocol not easily overcome.) When this happens, the foreground and background colors will be 
switched back and the bell will sound in warning. 

CHARACTER CLASSES 

Qicking the middle mouse button twice in rapid succession will cause all characters of the same 
class (e.g. letters, v^iiite space, punctuation) to be selected. Since different people haW different 
preferences for what should be selected (for example, should filenames be selected as a \v1iole or 
only the separate subnames), the default mapping can be overridden through the use of the char- 
Class (class CharOass) resource. 

This resource is simply a list of range-value pairs where the range is either a single number or 
low-hi^ in the range of to 127, corresponding to the ASCII code for the character or characters 
to be set. The vabie is arbitrary, although the default table uses the character number of the first 
character occurring in the set 

The default table is: 

static int charClass[128] = { 

/* NUL SOH STX ETX EOT ENQ ACK BEL */ 

32, 1, 1, 1, 1, 1, 1, 1, 
/* BS HT NL VT NP CR SO SIV 

1 32 111111 
/*DLe'dC1 DC2 DC3 DO* NAK SYN ETB*/ 

1, 1, 1, 1, 1, 1, 1, 1, 
/• CAN EM SUB ESC FS GS RS US */ 

1, 1, 1, 1, 1, 1, 1, 1, 
/• SP !"#$%& 'V 
32, 33, 34, 35, 36, 37, 38, 39, 

/*()• + ,-• /V 

40, 41, 42, 43, 44, 45, 46, 47, 
/• 01234567*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/• 8 9 : ; < = > ?*/ 

48, 48, 58, 59, 60, 61, 62, 63, 
/•©ABCDEFG*/ 

64, 48, 48, 48, 48, 48, 48, 48, 
/•HIJKLMNO*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/•PQRSTUVWV 

48, 48, 48, 48, 48, 48, 48, 48, 
/* X Y Z [ \ ] " V 

48, 48, 48, 91, 92, 93, 94, 48, 
/•'abcdefg*/ 

%, 48, 48, 48, 48, 48, 48, 48, 
/* h i j k 1 m n oV 

48, 48, 48, 48, 48, 48, 48, 48, 
/*pqrstuvw*/ 

48, 48, 48, 48, 48, 48, 48, 48, 
/• X y z { I } - DEL*/ 

48, 48, 48, 123, 124, 125, 126, 1}; 

For example, the string "33:48,37:48,45-47:48,64:48" indicates that the exclamation mark, percent 
sign, dash, period, slash, and ampersand characters should be treated the same way as characters 
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and numbers. This is veiy useful for cutting and pasting electronic mailing addresses and 
filenames. 

ACTIONS 

It is possible to rebind kejs (or sequences of keys) to arbitrary strings for input, by changing the 
translations for the vtlOO or tek4014 widgets. Changing the translations for events other than key 
and button events is not e}q)ected, and will cause unpredictable behavior. The following actions 
are provided for using within the vtlOO or tek4014 translations resources: 

bell((pcrcen?]) 

This action rings the keyboard bell at the specified percentage above or below the base 
volume. 

ignoreO This action ignores the event but checks for special pointer position escape sequences. 

insertO This action is a synonym for insert-seven-bitO 

insert-seven-bitQ 

This action inserts the character or string associated with the keysym that was pressed. 
The character or string is obtained using the standard interpretation of Shift, Lock and 
group modifiers as defined by the X Protocol Specification. 

insert-eight-bitO 

This action is the same as insert-seven-bit() except that single characters obtained iising 
the standard interpretation are modified according to the resource, e^tBitlnput. 

iiisert-selection(.sourcename [, ^]) 

This action inserts the string found in the selection or cutbufifer indicated by sounxname. 
Sources are checked in the order given (case is significant) until one is found. 
Commonly-used selections include: PRIMARY, SECONDARY, and CLIPBOARD. Cut 
buffers are typically named CUTBUFFERO through CUT_BUFFER7. 

keymap{name) 

This action dynamically defines a new translation table whose resource name is name 
with the suSixKeymap (case is significant). The name None restores the original trans- 
lation table. 

popup-menu(menunanie) 

This action displays the specified popup menu. Valid names (case is significant) include: 
mainMenu, vtMenu,fontMenu, and tekMenu. 

secureO This action toggles the Secure Keyboard mode described in the section named SECU- 
RITY, and is invoked from the securekbd entry in mainMenu. 

select-startO 

This action begins text selection at the current pointer location. See the section on 
POINTER USAGE for information on making selections. 

select-extendO 

This action tracks the pointer and extends the selection. It should only be bound to 
Motion events. 

select'eni(destname [, ^]) 

This action puts the currently selected text into all of the selections or cutbuffeis 
specified by destname. 

select-cursor-startO 

This action is similar to select-start except that it begins the selection at the current text 
cursor position. 

select-catsor-eni(destname [, ^]) 

This action is similar to select-end except that it should be used with select-oirsor-start. 

setM-tontid/l/2/3/4/e/s [/wrmalfont [, boldfont]]) 

This action sets the font or fonts currently being used in the VT102 window. The first 
argument is a single character that specifies the font to be used: d ox D indicate the 
default font (the font initially used when xterm was started), 1 through 4 indicate the 
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fonts specified by thcfontl through /onf^^ resources, e or £ indicate the normal and bold 
fonts that may be set through escape codes (or specified as the second and third action 
arguments, respectively), and i or/ indicate the font selection (as made by programs such 
dsxfontsel(J.y) indicated by the second action argument. 

start-extendO 

This action is similar to select-start exc^t that the selection is extended to the current 
pointer location. 

start-cursor-extendO 

This action is similar to select-extend e«;ept that the selection is extended to the current 
text cursor position. 

string(5^/}g) 

This action inserts the specified text string as if it had been typed. Quotation is necessary 
if the string contains whitespace or non-alphanumeric characters. If the string argument 
begins with the characters "Ox", it is interpreted as a hex character constant 

scroll-back(coun^ [^nits\) 

This action scrolls the text window backward so that text that had previously scrolled off 
the top of the screen is now visible. The count argument indicates the number of unks 
(which may bepa^, halpage, pixel, or line) by which to scroll. 

scroII-forw(coun^ [^nits]) 

This action scrolls is similar to scroll-back e»;ept that it scrolls the other direction. 

allow-send-events(ow/o)57toggfe) 

This action set or toggles the allowSendEvents resource and is also invoked by the 
allowsends entry in mainMenu. 

set-logging(on/off/toggle) 

This action toggles the logging resource and is also invoked by the logging entry in main- 
Menu. 

redrawO 

This action redraws the window and is also invoked by the redraw entry in mainMenu. 

send-signal(5{^ame) 

This action sends the signal named by sigfiame (which may also be a number) to the 
xterm subprocess (the shell or program specified with the -e command line option) and is 
also invoked by the suspend, continue, interrupt, hangup, terminate, and kiU entries in 
mainMenu. Allowable signal names are (case is not significant): suspend, tstp (if sup- 
ported by the operating system), com (if supported by the operating system), im, hup, 
term, and kill. 

quit() This action sends a SIGHUP to the subprogram and exits. It is also invoked by the quit 
entry in mainMenu. 

set-serollhar(on/ojf /toggle) 

This action toggles the scrollbar resource and is also invoked by the scrollbar entry in 
vtMenu. 

sel'jumpscroU(pn/ojf/toggle) 

This action toggles the jumpscroU resource and is also invoked by the jumpscroll entry 
in VtMenu. 

set-reverse-yidtoion/off/toggle) 

This action toggles the reverseVideo resource and is also invoked by the reversevideo 
entry in vtMenu. 

set-autowrapion /off/ toggle) 

This action toggles automatic wrapping of long lines and is also invoked by the autowrap 
entry in vtMenu. 

set-rwersewra.p(on/off/toggle) 

This action toggles the reverseWrap resource and is also invoked by the reversewrap 
entry in vtMenu. 
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s«!t-autolineteed{on/off/tog^) 

This action toggles automatic insertion of linefeeds and is also invoked by the auto- 
linefeed entry in vtMenu. 

set-appcursorion /off/ tog^) 

This action toggles the handling Application Cursor Key mode and is also invoked by the 
Bappcursor entry in vtMenu. 

set-applaeypadion /off/ toggle) 

This action toggles the handling of Application Keypad mode and is also invoked by the 
appk^pad entry in vtMertu. 

set-seroU-onrlseyion/off/togg/e) 

This action toggles the scrolIKey resource and is also invoked from the scrollk^ entry in 
VtMenu. 

s«it-scroU-on4ty-output(on /off/ toggle) 

This action toggles the scroUTtyOutput resource and is also invoked from the scroUt- 
tyoutput entry in vtMenu. 

set-allowl32{on/off/toggle) 

This action toggles the cl32 resource and is also invoked from the allowl32 entry in 
VtMenu. 

set-eursesemal(on /off/ to^e) 

This action toggles the curses resource and is also invoked from the cursesemul entry in 
uMenu. 

set-visuaI-belI(on/oj57togg/e) 

This action toggles the visualBell resource and is also invoked by the visualbell entry in 
VtMenu. 

set-mar^tiHtUion /off/ toggle) 

This action toggles the marginBell resource and is also invoked from the margiiibell 
entry in vtMenu. 

s^-altscreen{on/off/toggle) 

This action toggles between the alternative and current screens. 

soft-resetQ 

This action resets the scrolling region and is also invoked from the softreset entry in 
VtMenu. 

hard-reset() 

This action resets the scrolling region, tabs, window size, and cursor keys and clears* the 
screen. It is also invoked from the hardreset entry in vtMenu. 

set-termiiial-type(^/>e) 

This action directs output to either the vt or tek windows, according to the type string. It 
is also invoked by the tekmode entry in vtMenu and the vtmode entry in tekMenu. 

set-visihility(yt/tekfin /off/ toggle) 

This action controls whether or not the vt or tek windows are visible. It is also invoked 
from the tekshow and vthide entries in vtMenu and the vtshow and tekhide entries in tek- 
Menu. 

set-tek4ext(/a/ge/2/5/s/na//) 

This action sets font used in the Tektronix window to the value of the resources tek- 
textlarge, tektext2, tektext3, and tektevtsmall according to the argument It is also by the 
entries of the same names as the resources in tekMenu. 

tek-pageO 

This action clears the Tektronix window and is also invoked by the telqpage entry in tek- 
Menu. 

tek-reset() 

This action resets the Tektronix window and is also invoked by the tekreset entry in 
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tekMenu. 

tek-«opy() 

This action copies the escape codes used to generate the current window contents to a 
file in the current directory beginning with the name COPY. It is also invoked from the 
tekcopy entry in tekMenu. 

The Tektronix window also has the following action: 

^■^ress(l/L/m/M/r/R) 

This action send the indicated graphics input code. 

The default bindings in the VT102 window are: 



Shift <KeyPress> Prion 

Shift <KeyPress> Next: 

Shift <KeyPress> Select: 

Shift <KeyPress> Insert: 
"Meta < KeyPress > : 
Meta < KeyPress > : 
Ctrl "Meta < BtnlDown > : 
'Meta < BtnlDown >: 
"Meta <BtnlMotion>: 
Ctrl "Meta <Btn2Down>: 
"Ctrl 'Meta <Btn2Down>: 
"Ctrl "Meta <Btn2Up>: 
Ctrl "Meta <Btn3Down>: 
"Ctrl "Meta <Btn3Down>: 
"Meta <Btn3Motion>: 
"Ctrl "Meta <BtnUp>: 
<BtnDown>: 



scroll-back(l,hal^ge) \n\ 

scroll-forw(l,halfipage) \n\ 

select-cursor-startQ \ 

select-cursor-end(PRIMARY, CUTBUFFERO; 

insert-selection(PRIMARY, CUT_BUFFERO) \ 

insert-seven-bit() \n\ 

insert-eight-bit() \n\ 

popup-menu(mainMenu) \n\ 

select-start() \n\ 

select-extendQ \n\ 

popup-menu(vtMenu) \n\ 

ignoreO \n\ 

insert-selection(PRIMARY, CUTBUFFERO) \ 

popup-menu(fontMenu) \n\ 

start-extendQ \n\ 

select-extend() \n\ 

select-end(PRIMARY, CUT BUFFERO) \n\ 

bell(0) 



The default bindings in the Tektronix window are: 

" Meta < KeyPress > : 

Meta < KeyPress > : 
Ctrl "Meta < BtnlDown >: 
Ctrl "Meta <Btn2Down>: 
Shift "Meta < BtnlDown >: 

"Meta <BtnlDown > : 
Shift "Meta<Btn2Down>: 

'Meta < Btn2Down > : 
Shift "Meta<Btn3Down>: 

"Meta < BtnSDown > : 



insert-seven-bitO \n\ 
insert-eight-bit()\n\ 
popup-menu(mainMenu) \n\ 
popup-menu(tekMenu) \n\ 
gin-press(L) \n\ 
gin-press(l) \n\ 
gin-press(M) \n\ 
gin-press(m) \n\ 
gin-press(R) \n\ 
gin-press(r) 



Below is a sample how of the k^mapO action is used to add special keys for entering commonly- 
typed works: 

•VTlOO.Translations: #override <Key>F13: keymap(dbx) 
*VT100.dbxKeymap.translations: \ 

<Key>F14: keymap(None) \n\ 

< Key > F17: stringCnext") string(OxOd) \n\ 

< Key > F18: stringfstep") string(OxOd) \n\ 

< Key > F19: string("continue") string(OxOd) \n\ 

<Key>F20: string("print ") insert-selection(PRIMARY, CUT_BUFFERO) 

OTHER FEATURES 

Xterm automatically highlights the window border and text cursor when the pointer enters the 
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window (selected) and unhighlights them when the pointer leaves the window (unselected). If the 
window is the focus window, then the window is highlighted no matter where the pointer is. 

In Vn02 mode, there are escape sequences to activate and deactivate an alternate screen buffer, 
which is the same size as the display area of the window. When activated, the current screen is 
saved and replace with the alternate screen. Saving of lines scrolled off the top of the window is 
disabled until the normal screen is restored. The temtcapiS) entry totxterm allows the visual edi- 
tor vi(l) to switch to the alternate screen for editing, and restore the screen on exit 

In either VT102 or Tektronix mode, there are escape sequences to change the name of the win- 
dows and to specify a new log file name. 

ENVIRONMENT 

Xterm sets the environment variables "TERM" and "TERMCAP" properly for the size window 
you have created. It also uses and sets the environment variable "DISPLAY" to specify which bit 
map display terminal to use. The environment variable "WINDOWID" is set to the X window id 
number of the xterm window. 

SEE ALSO 

resize(l),X(l),pty(4),tly(4) 
Xtemt Control Sequences 

BUGS 

The Xterm Control Sequences document has yet to be converted from XIO. The old version, along 
with a first stab at an update, are available in the sources. 

The class name is XTerm instead oi Xterm. 

Xterm will hang forever if you try to paste too much ttsst at one time. It is both producer and con- 
sumer for the pfy and can deadlock. 

Variable-width fonts are not handled. 

This program still needs to be rewritten. It should be split into very modular sections, with the 
various emulators being completely separate widgets that don't know about each other. Ideally, 
you'd like to be able to pick and choose emulator widgets and stick them into a single control 
widget. 

The focus is considered lost if some other client (e.g., the window manager) grabs the pointer; it is 
difficult to do better without an addition to the protocol. 

There needs to be a dialog box to allow entry of log file name and the COPY file name. 

Many of the options are not resettable after xterm starts. 

The Tek widget does not support key/button re-binding. 

COPYRIGHT 

Copyright 1989, Massachusetts Institute of Technology. 
See X{1) for a full statement of rights and permissions. 

AUTHORS 

Far too many people, including: 

Loretta Guarino Reid (DEC-UEG-WSL), Joel McCormack (DEC-UEG-WSL), Terry Weissman 
(DEC-UEG-WSL), Edward Moy (Berkeley), Ralph R. Swick (MIT-Athena), Mark Vandevoorde 
(MIT-Athena), Bob McNamara (DEC-MAD), Jim Gettys (MIT-Athena), Bob Scheifler (MIT X 
Consortium), Doug Mink (SAO), Steve Pitschke (Stellar), Ron Newman (MIT-Athena), Jim Ful- 
ton (MIT X Consortium), Dave Serisky (HP) 
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accelerator 

A key or sequence of keys (typically a modifier key and some other key) 
that provides a "shortcut," for accessing functionality. 

action definition database 

The files that define the actions known to the system. The actions provide 
the ability to represent commands graphically. They also provide the ability 
associate default comnaands with particular file types, and to execute 
commands from the file manager Actions menu. 

active window 

The terminal window where what you type appears. If there is no active 
window, what you type is lost. Only one terminal window can be active at 
a time. 

ampersand (&) 

The character placed at the end of a command to specify that the client 
started by the command should be started as a background process. The 
command can be typed after the command-line prompt or included in a file 
such as .vueprof ile. 

application program 

A computer program that performs some useful function, such as word 
processing or data base management. 

application server 

A computer used solely to provide processing power for application 
programs. 
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backdrop 

The pixmap used as the visual background for a workspace. 

background process 

A process that doesn't require the total attention of the computer for 
operation. Background processing enables the operating system to execute 
more than one program or command at a time. As a general rule, all clients 
should be run as background processes. 

bitmap 

Generally speaking, an array of data bits used for graphic images. Strictly 
speaking, a pixmap of depth one (capable of 2-color images). 

bitmap device 

An output device that displays bitmaps. The CRT monitor of your system 
is a bitmap device. 

Broadcast Message Server 

A component of HP VUE that provides communication between HP VUE 
clients. 

buffer 

An area used for storage. 

button 

A button on a mouse pointing device. Mouse buttons can be mapped to the 
keyboard. 

button binding 

Association of a mouse button operation with a window manager function. 
For example, pressing button 3 on a window frame displays the system 
menu. 

button mapping 

Association of a button number with a physical mouse button. 

click 

To press and release a mouse button. The term comes from the fact that 
pressing and releasing the buttons of most mice makes a clicking sound. 
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click 

To press and release a mouse button. The term comes from the fact that 
pressing and releasing the buttons of most mice makes a clicking sound. 

client 

A program written specifically for the X Window System. Some clients 
make their own windows. Other clients are utility programs. 

color palette 

A collection of colorsets. 

color set 

A collection of colors that define the foreground, background, and shadow 
colors of a particular display element. A color palette consists of a 
collection of color sets. 

combined mode 

A combination of image and overlay planes in which a single display has a 
single screen that is a combination of the image and overlay planes. 

command-Une prompt 

A command-line prompt shows that the computer is ready to accept 
your commands. Each terminal emulation window has a command-line 
prompt that acts just like the command-line prompt you see on the screen 
immediately after login. Usually the command-line prompt is either a $ 
(for Bourne and Korn shells) or a '/, (for C shells), but it can be modified. 
One popular modification is to print the current working directory and the 
history stack number before the $ or '/. You can find the command-line 
prompt by pressing (Return) several times. Everytime you press ( Return 1 , 
HP-UX prints the prompt. 

cluster 

A network of computers in which only one computer has file-system disk 
drives attached to it. 

current session 

The session to which you are logged in at a particular time. 
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cut buffer 

A buffer (memory area) that holds text that has been deleted from a file. 

default 

An appearance or behavior that occurs if no other option is explicitly 
specified. 

depth 

The number of planes in a set of planes. For example, a set of 12 image 
planes would have a depth of 12. 

dialog box 

Sometimes called a secondary window, the dialog box is called by the user 
from the application's main window. A dialog box contains controls or 
settings, and sometimes prompts for text entry. 

diskless cluster 

The networking of several systems (SPUs) together to share a common hard 
disk for storage of data and programs. 

display 

Strictly speaking, the combination of a keyboard, mouse, and one or more 
screens that provide input and output services to a system. While "display" 
is sometimes used to mean just the CRT screen, a display, as defined here, 
can actually include more than one physical screen. 

display server 

In the X Window System, the display server is the software that controls 
the communication between client programs and the display (keyboard, 
mouse, and screen combination). 

double buffering 

A term describing the method used by Starbase wherein half of the color 
planes on a monitor are used to display to the screen and the other half are 
used to compute and draw the next screen display. This provides smooth 
motion for animation and it is faster. However, it does reduce the number 
of colors that are available for display on the screen at one time. 
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double- click 

To press and release a mouse button twice in rapid succession. 

drag 

To press and hold down a mouse button while moving the m^ouse on the 
desktop (and the pointer on the screen). Typically, dragging is used with 
menu selecting, moving, and resizing operations. 

drop 

Releasing an icon that has been "dragged" to a new position. To drop the 
icon, release the mouse button. 

environment variable 

An element of your workstation software that can be set to a value, then 
read by applications to influence their behavior. 

file manager 

The HP VUE application that allows you to manage your flies and 
directories, and set viewing preferences. 

file server 

A computer whose primary task is to control the storage and retrieval of 
data from hard disks. Any number of other computers can be linked to the 
file server in order to use it to access data. This means that less storage 
space is required on the individual computer. 

file type database 

The flies that deflnes the flle types recognized by the system. Different flle 
types can have different flle manager icons and default actions. 

fonts 

A font is a style of printed text characters. Times Roman is the font used 
for most newspaper text; Helvetica is the font used for most newspaper 
headlines. 

foreground process 

A process that has the terminal window's attention. When a program is 
run in a window as a foreground process (as opposed to a background 
process), the terminal window cannot be used for other operations until the 
process is terminated. 
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graphical user interface 

A form of comiminication between people and computers that uses 
graphics-oriented software such as windows, menus, and icons, to ease the 
burden of the interaction. 

$HOM£ 

The value of the environment variable representing the home directory. 

home directory 

The directory in which you are placed after you log in. Typically, this is 
/users/ username, where username is your login name. The home directory 
is where you keep all "your" files. 

home session 

A session stored explicitly using the Style Manager Startup dialog box, to 
which you can always return. 

hotspot 

The area of a graphical image used as a pointer or cursor that is defined as 
the "point" of the pointer or cursor. 

hpterm 

A type of terminal window, sometimes called a "terminal emulator 
program" that emulates HP2622 terminals, complete with softkeys. hpterm 
is the default terminal emulator for HP-UX and OSF/1 systems running HP 
VUE. 

icon 

A small, graphic representation of an object on the root window (typically a 
terminal window). Objects can be "iconified" (turned into icons) to clear a 
cluttered workspace and "restored" (returned to their original appearance) 
as needed. Processes executing in an object continue to execute when the 
object is iconified. 

iconify 

The act of turning a window into an icon. 

image mode 

The default screen mode using multiple image planes for a single screen. 
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The number of image planes determines the variety of colors that are 
available to the screen. 

image planes 

The primary display planes on a device that supports two sets of planes. 
The other set of display planes is known as the overlay planes. These two 
sets of planes are treated as two separate screens in stacked mode and one 
screen in combined mode. 

indicator 

A control in the workspace manage that indicates the status of a file. 

input device 

Any of several pieces of equipment used to give information to the system. 
Examples are the keyboard, a mouse, or a digitizer tablet. 

input focus 

When a program has input focus, it receives input from the keyboard and 
mouse. 

keyboard binding 

Association of a special key press with a window manager function. For 
example, pressing the special keys [shift] [Esc] displays the system menu of 
the active window. 

label 

The text part of an icon. 

local access 

The ability to run a program on the computer you are currently operating. 
This is different from remote access, where you run a program on a 
computer that is physically removed from the one you are operating. 

local client 

A local client is a program that is running on your local computer, the 
same system that is running your X server. 

login 

The user's login name. 
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login manager 

The program that controls the Initial startup of HP VUE, accepts the user's 
login and password, and then starts the session manager. 

mask 

A graphical image used in conjunction with another graphical element to 
hide unwanted graphical effects. 

matte 

A border located just inside the window between the client area and the 
frame. It is used to create a three-dimensional effect for the frame and 
window. 

maximize 

To enlarge a window to its maximum size. 

maximize button 

A window-frame push button used to enlarge the window to its maximum 
size. 

menu 

A list of selections from which to make a choice. In a graphical user 
interface such as the X Window System, menus enable you to control the 
operation of the system. 

menu bar 

A area at the top of a window that contains the titles of the pull down 
menus for that application. 

minimize 

To turn a window into an icon. The terms minimize and iconify are 
interchangeable. 

modifier key 

A key that, when pressed and held along with another key, changes the 
meaning of the other key. (ctrl) , (Extend char) , and (shift) are examples of a 
modifier key. 
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mouseless operation 

Although a mouse makes it easy to use the X Window System, the mouse 
is not absolutely necessary. The system can be configured to run from the 
keyboard alone. 

multi-tasking 

The ability to execute several programs (tasks) simultaneously on the same 
computer. 

node 

An address used by the system. For example, each device on the system 
has its own node. The system looks there whenever it needs to access the 
device. A node can also be an address on a network, the location of a 
system. 

non-client 

A program that is written to run on a terminal and so must be "fooled" by 
a terminal emulation window into running in the window environment. 

normalize 

To change an icon back into its "normal" (original) appearance — same as 
"restore" . The opposite of iconify. 

overlay planes 

The secondary set of display planes on a device that supports two sets of 
planes. The other set of display planes is known as the image planes. These 
two sets of planes are treated as two separate screens. 

palette 

A collection of color sets that creates an attractive color scheme for the 
display. Each palette has a unique name. 

parent window 

A window that causes another window to appear. A window that "owns" 
other windows. 

paste 

Inserting data into an area. 
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pixel 

Short for "picture element." The individual dots, or components, of a 
screen. They are arranged in rows and columns and form the images that 
are displayed on the screen. 

pixmap 

An array of data bits used for graphics images. Each pixel (picture element) 
in the map can be several bits deep, resulting in multi-color graphics 
images. 

pointer 

Sometimes called the "mouse cursor," the pointer shows the location of the 
mouse. The pointer's shape depends on its location. In the root window, 
the pointer is an x . On a window frame, the pointer is an arrowhead. 
Inside the frame, the pointer can be an arrowhead (as when it is inside a 
clock or load histogram frame) or an I-beam (as when it is inside a terminal 
window). 

pointing device 

A device that moves the pointer on the display screen. A pointing device 
is used with a graphical user interface, like HP VUE, that allows you to 
select and manipulate a graphical object by "pointing" to it. The mouse is 
probably the most familiar pointing device. 

pop- up menu 

A menu that provides no visual cue to its presence, but simply pops up 
when people perform a particular action. Pop-up menus are associated with 
a particular area of the workspace. 

press 

Strictly speaking, to hold down a mouse button or a key. Note that to hold 
down a mouse button and move the mouse is called "dragging." 

print server 

A computer that controls spooling and other printer operations. This 
permits a large number of individuals to efficiently share printer resources. 

poll down menu 

A menu that is pulled down from a client application's title bar. 
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push button 

A graphic control that simulates a real-life push button. Use the pointer 
and mouse to push the button and immediately start an action. 

remote access 

The ability to run a program on a computer that is physically removed 
from the one you are currently operating. This is different from local access, 
where you run a program on the computer that you are operating. 

remote client 

An X program that is running on a remote system, but the output of the 
program can be viewed on your terminal. 

remote host 

A computer physically removed from your own that you can log in to. See 
chapter 4 for prerequisites for establishing a remote host. 

resize handles 

The frame part that is used to change the height or width of the window. 

resource 

That which controls an element of appearance or behavior. Resources are 
usually named for the elements they control. 

resource database 

The accumulation of resources for an application. The resources may be 
obtained from a variety of places. They are managed by the resource 
manager for the application. 

resource files 

Files containing resource specifications 

resource manager 

The component of the X Window System that creates the application's 
resource database. 

RESOURCE_MANAGER property 

A property on the root window that is accessed by the resource manager. It 
is loaded and managed using the xrdb client. 
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restoring 

The act of changing an minimized (iconified) or maximized window 
back to its regular size. The terms restoring and normalizing are usually 
interchangeable. 

.r hosts 

A special file used in network environments that enables a remote user to 
log into your local system without using a password. Obviously, this has a 
considerable impact on the security of your system. 

root menu 

The menu associated with the root window. The root menu enables you to 
control the behavior of your environment. 

root window 

The root window is what the "screen" (the flat viewing surface of the 
terminal) becomes when you start X. To a certain extent, you can think 
of the root as the screen. The root window is the backdrop of your X 
environment. Although you can hide the root window under terminal 
windows or other graphic objects, you can never position anything behind 
the root window. All windows and graphic objects appear "stacked" on the 
root window. 

screen 

The physical CRT (Cathode Ray Tube) that displays information from the 
computer. 

screen dump 

An operation that captures an image from your screen, saves it in a file, and 
enables you to send that file to a printer for hardcopy reproduction. 

scroll bar 

A graphical device used to change your viewpoint of data. A scroll bar 
consists of a slider, scroll area, and scroll arrows. A person changes the 
view by sliding the slider up or down in the scroll area or by pressing one of 
the scroll arrows. 

server 

A program that controls all access to input devices (typically a mouse and a 
keyboard) and all access to output devices (typically a display screen). It is 
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an interface between application programs you run on your system and the 
system input and output devices. 

session 

The time between when you log in and when you log out. 

session manager 

The program that provides the ability to restore the previous or home 
session the next time the user logs in. When a user logs in, the session 
manager starts the workspace manager and other programs that were 
running during a previous session. 

stacked mode 

A combination of image and overlay planes in which a single display has 
two "logical" screens, one the image planes, the other the overlay planes. 
Typically, the image planes are used to display graphics while the overlay 
planes are used to display text. 

style manager 

The HP VUE application that provides the ability to customize various 
aspects of your system, including colors, fonts, the keyboard and mouse, 
session startup and temination behavior, and access to other machines. 

system font 

The font used for window titles, menu bar labels, and button labels. 

system menu 

The menu displayed when you press the system menu button on the HP 
Window Manager window frame. Every window has a system menu that 
enables you to control the size, shape, and position of the window. 

TermO 

An HP level terminal. It is a reference standard that defines basic 
terminal functions. For more information, see TermO Reference in the 
HP-UX documentation set. 

terminal-based program 

A program (non-client) written to be run on a terminal (not in a window). 
Terminal-based programs must be "fooled" by terminal-emulation clients to 
run on the X Window System. 
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terminal emulator 

A client program that provides a window within which you can run 
non-client programs. The non-client program runs just as though it were 
running from a real terminal rather than a window acting as a terminal. 

terminal type 

The type of terminal attached to your computer. HP-UX uses the terminal 
type to set the TERM environment variable so that it can communicate with 
the terminal correctly. The terminal type is usually set at login, but can be 
set afterward. 

terminal window 

A terminal window is a window that emulates a complete display terminal. 
Terminal windows are typically used to "fool" non-client programs into 
believing they are running in their favorite terminal — not a difficult task in 
most cases. When not running programs or executing operating system 
commands, terminal windows display the command-line prompt. Two 
terminal windows are supplied with Xll— hpterm, which emulates HP 
terminals, and xterm, which emulates DEC and Tektronix terminals. 

text cursor 

The line-oriented cursor that appears in a terminal window after the 
command prompt. The term is used to distinguish the cursor used by a 
window from the cursor used by the mouse, the pointer. 

threshold 

The distance the mouse pointer moves before accelerating. 

tile 

A rectangular area used to cover a surface with a pattern or visual texture. 
The HP Window Manager supports tiling, enabling users with limited color 
availability to create new color tiles blended from existing colors. 

title bar 

The title bar is the rectangular area between the top of the window and the 
window frame. The title bar contains the title of the window object. 

transient window 

A window of short duration such as a dialog box. The window is only 
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displayed for a short time, usually just long enough to get some direction 
from the user. 

user font 

The font used for text the user types in. 

window 

A data structure that represents all or part of the CRT display screen. 
It contains a two-dimensional array of 16-bit character data words, a 
cursor, a set of current attributes, and several flags. Visually, a window is 
represented as a rectangular subset of the display screen. 

window-based program 

A client or program written for use with the X Window System. The 
"opposite" of a window-based program is a terminal-based program. 

window decoration 

The frame and window control buttons that surround windows managed by 
the HP Window Manager. 

window frame 

The area surrounding a window. A window frame can consist of a resize 
border, a window menu button, a title bar, and window control buttons. 

window manager 

The window manager controls the size, placement, and operation of 
windows on the root window. The window manager includes the functional 
window frames that surround each window object as well as a menu for the 
root window. 

window menu 

The menu displayed when you press the window menu button on a window 
frame. It lets you control the size, shape, and position of the window. 

window menu button 

The control button at the left side of the title bar in the window frame. It 
is used to display the window menu. 
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workspace 

Thie workspace is a display-sized windoe onto which application windows 
are placed. A screen can have multiple workspaces. You use the workspace 
switch in the workspace manager to switch from one workspace to another. 

workspace manager 

The portion of HP VUE that displays various controls for manipulating the 
contents of workspaces. 

workspace menu 

The menu associated with the workspace window. Same as the "root" 
menu. 

workspace switch 

The set of push buttons in the workspace manager that let you switch from 
one workspace to another. 

XO.hosts 

A iile that tells the X Window System which remote hosts can access the 
local server and hence the local display. 

xclock 

An HP VUE client program that displays the time, either analog (hands 
and dial) or digital (text read out). 

xload 

An HP VUE client program that displays the work load of the system as a 
histogram. 

xterm 

An Xll client program that displays a terminal window that emulates DEC 
and Tektronix terminals, xterm is the default terminal emulator in HP 
VUE for all operating systems except HP-UX and OSF/1. 
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Special characters 

&, 7-1 



accelerators, 11-37 
action 

allowed file types, 12-20 

arguments, 12-26 

copying, 12-15 

current working directory, 12-26 

default, 12-13 

execution host, 12-22 

graphical representations, 12-15 

icons, 12-20 

invoking, 12-13 

mapping, 12-21 

name, 12-20 

order specified, 12-28 

remote execution, 12-27 

remote execution host, 12-27 

window type, 12-22 
action definition database, 12-13 

introduction, 12-2 

order of entries, 12-28 

organization, 12-13 
action definition directories, adding, 

12-6 
action definition files 

general syntax rules, 12-6 

location, 12-2 
action definitions 

adding, 12-17 



aflfected by update, 12-3 

examples, 12-28 

exec-host, 12-22 

exec-string, 12-23 

fields, 12-19 

introduction, 12-1 

location of, 12-2 

search path, 12-18 

syntax, 12-19 
action icon 

size, 12-20 
action name, 12-20 
actions 

in workspace manager, 13-12 
actions field, 12-12 
Actions menu 

contents, 12-12, 12-15 
active clients 

in workspace manager, 13-2 
activeColorSetId resource, 8-13, 9-14, 

11-6 
active window, 11-48 
alarmTime resource, 6-7 
alias name, 10-6 

allocating colors for Starbase, 3-4 
animation, 13-14 
app-defaults, 8-1, 8-2, 9-1 

for window manager, 13-3 

for workspace manager, 13-3 

help manager, 9-19 

style manager, 9-5 
app-defaults, language-dependent, 3-8 
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applications 

obtaining resources, 8-1 

window, 12-6 
applications directory, 12-6, 12-13 

symbolic links, 12-14 
autorepeat, 9-17 

B 

backdrop, 11-24, 11-31 

adding, 11-27 

assigning to a workspace, 11-25 

color, 11-28 

covering root window, 11-31 

deep, 11-28 

default color, 11-29 

directory, 11-25 

explicit colors, 11-30 

using root window, 11-26 
background 

in color sets, 9-10 
background processing, 7-1 
beeper settings, 9-17 
bell settings, 6-8 
bindings,default, 11-43 
bitmap 

workspace backdrop, 11-25 
bitmapDirectory resource, 11-24 
bitmapped fonts, 10-1 
bold text, meaning, 1-3 
boot, 5-2 

booting HP VUE, 5-6 
borderWidth resource, 13-5 
box around text, meaning, 1-3 
braces enclosing text, meaning, 1-3 
brackets enclosing text, meaning, 1-3 
Broadcast Message Server, 2-5, 4-5, 6-1, 
6-4, 15-1 

failing to start, 6-8, 6-10 

installation, 15-2 

multiple screens, 3-3 

run from a startup script, 14-2 



running vuewm without, 14-3 

security, 4-10 

with Softbench, 15-4 
busy light, see progress control, 13-12 
button binding 

context, 11-40 

syntax, 11-40 
button bindings, 11-39 

default, 11-41 

file containing, 11-3 

modifying, 11-43 
B_W color use, 9-9 



cached clients 

changing resources for, 8-11 

help manager, 9-19 

killing, 7-6 
caching 

effect on fonts, 10-5 

hpterm and xterm, 9-3 

resources for, 9-4 
canceling a session, 6-9 
capital letters, 1-4 
case letters, 1-4 
case sensitivity, 1-4 
class defaults, 8-2 
classes of clients, 8-17 
classes of resources, 8-17 
client 

resources, 7-2 
clientDecoration resource, 11-10 
clients 

appearance, 11-15 

cached, 8-11 

caching, 10-5 

classes, 8-17 

colors, 8-12 

display option, 7-2 

fonts, 10-5, 10-6 

HP VUE clients, 2-2 
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in workspace manager, 13-2 

names, 8-17 

naming, 8-17 

non-saved, 6-10 

remote, 7-4 

starting, 7-4 

stopping, 7-4 

syntax of resources, 8-12 
client-specific font resources, 10-7 
client window 

adding to workspace manager, 13-24 
closing cached clients, 8-11 
cluster 

data access, 4-3 

remote, 4-4 

security in, 4-10 
cluster systems 

vuelogin, 5-3 
color, 8-12 

backdrops, 11-28 

changing dynamically, 9-7 

display components, 9-14 

dynamic, 9-16 

frame elements, 11-7 

icons, 11-17 

names, 8-13 

options, 8-12 

palettes, 9-8 

reducing usage, 9-16 

resources affected by style manager, 
9-15 

rgb specifications, 8-13 

set by style manager, 9-7 

setting, 8-13 

shadow, 9-10 

Starbase, 3-4 

usage, 9-10, 9-12 

using hexadecimal values, 8-13 

window frames, 11-6 

workspace manager, 13-5 
colorable elements, 8-13 



colormapFocusPolicy resource, 11-48 
color set Id, 8-13 
colorSetld resource, 11-30, 13-5 
color sets, 9-10 

assigned to backdrops, 11-30 

mapped to display components, 9-14 

number in palette, 9-9 
colorUse resource, 9-9 
COLUMNS environment variable, 11-52 
COMMAND action type, 12-21 
Command Invoker, 2-5 
command line 

general syntax, 7-1 
command-line options, 7-2, 8-1, 8-2, 8-5 

syntax, 7-2 
commented resources 

loading with xrdb, 8-10 

syntax, 8-12 
computer text, meaning, 1-3 
configuration files 

vuewm, 11-3 

window manager, 11-3 

workspace manager, 13-6 
console, 5-18 
console getty, 5-2 
context 

icon, 11-32 

root, 11-32 
context-dependent files, 4-4 
contexts for keyboard bindings, 11-44 
context window, 11-32 
control characters for terminals, 9-3 
controlling communication, 2-2 
control options, 13-2 
controLoptions field, 13-10 
controls 

borders, 13-22 

names, 13-9 

options, 13-10 

size, 13-11 

syntax, 13-8 
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types, 13-8 
controlSpacing resource, 13-5 
control type 

specifying, 13-10 
conventions, 1-3 
copying an action, 12-15 
copyright message, 5-15 
coverScreen resource, 6-7 
current session database, 6-2 
current working directory for an action, 

12-26 
cursor 

workspace or root, 11-31 



data access 

from remote cluster, 4-4 

from same cluster, 4-4 
database files 

string variables, 12-12 
database search path, changing, 12- 
data file access 

using symbolic link, 4-5 
data files 

access, 4-2 

context-dependent, 4-4 

remote access, 4-3 

syntax of names, 4-2 
data host, 4-1 
data, remote, 4-2 
deep backdrops, 11-28 
default keyboard bindings, 11-43 
default palette file, 9-9 
defaults 

class specific, 8-2 
default workspace manager, 13-19 
devices, input, 3-4 
directories 

file management, 12-2 
diskless cluster, see cluster, 4-3 
diskless cluster systems 



vuelogin, 5-3 
display 

limiting access, 4-11 

lock, 6-6, 6-7 

options, 7-3 

server, 2-2 

specifying, 7-2 
display-dependent sessions, 5-18 
DISPLAY environment variable, 4-8, 

5-7, 5-8, 5-14, 7-2 
displaying fonts, 10-7 
displays, multiple, 5-16 
display types,screen names for, 11-5 
distributed operation 

basic concepts, 4-1 

Domain/OS systems, 4-1 
domain names, 4-3, 4-8 
drop effects 

in workspace manager, 13-14 
drop zone 

adding, 13-25 

specifying, 13-10 

workspace manager, 13-2 
dynamic color changes, 9-7 
dynamicColor resource, 9-16 
dynamic colors 

turning off, 9-16 



editing in HP VUE, 3-11 
end functions, 11-36 
ending sessions, 6-8 
environment variable 

TZ, 5-13 
environment variables, 8-1, 11-52 

built into vuelogin, 5-8 

DISPLAY, 5-14 

for Starbase, 3-5 

for Xstartup, 5-7 

setting in HP VUE, 5-7 

supplying resources, 8-1 
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used by Xstartup, 5-7 

.vueprofile, 5-4 

when not running HP VUE, 5-14 
errors 

session manager, 6-7, 6-10 
/etc/exports, 4-12 
/etc/hosts, 4-15 

changing host name, 4-14 
etc/passwd, 4-8 
/etc/rc file, 6-10 
exec-host field, 12-22 
exec-string, 12-23 

arguments, 12-24 

current working directory, 12-26 

multiple arguments, 12-26 

syntax, 12-24 
execution host 

definition, 4-1 

for actions, 12-22 
exiting 

programs, 7-5 
explicit focus policy, 11-49 



f. action 

in workspace manager, 13-12 
fadeNormallcon resource, 11-22 
feedback windows 

appearance, 11-15 
file icon 

size, 12-11 
file indicator 

adding to workspace manager, 13-25 

behavior of, 13-25 

specifying, 13-10 
file management database 

adding directories, 12-5 

default, 12-4 

directories, 12-2 

file locations, 12-2 

introduction, 12-1 



local, 12-4 

naming conventions, 12-2 

organization, 12-4 

personal, 12-4 

search path, 12-5 

string variables, 12-12 

structure, 12-2 

syntax rules, 12-6 
file manager, 9-21 

cached, 9-21 

colors, 9-14 

opening and closing, 9-21 
fileName resource, 13-14, 13-25 
fileSize resource, 9-21 
file status 

monitoring, 13-14 
file type 

actions in Actions menu, 12-12 

default action, 12-12 

default action for, 12-13 

requirements for, 12-10 
file type database 

general syntax rules, 12-6 

location, 12-2 
file type definitions 

location of, 12-2 
file types 

adding, 12-8 

affected by update, 12-3 

icons, 12-11 

introduction, 12-1 

syntax, 12-8 

valid for an action, 12-20 
file types database, 12-7 

introduction, 12-2 

order searched, 12-10 
file types fields, 12-8 
f.next-workspace function, 11-51 
focus policies, 11-48 
font 

bitmapped, 10-1 
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changes, 9-17, 10-4 

client-specific, 10-5, 10-6, 10-7 

definition, 10-1 

displaying, 10-7 

for help manager, 9-19 

icon, 11-18 

resources, 10-1, 10-3, 10-4 

resource syntax, 10-6 

scalable typeface, 10-1 

size, 10-2, 10-3 

specified manually, 10-7 

style manager, 10-1, 10-2, 10-3 

system, 10-2, 10-3 

user, 10-2, 10-3 

window frames, 11-6 

window manager, 11-10 
fontList resource, 11-10 
Fonts dialog box, 10-4, 10-5 
foreground 

changing dynamically, 9-12 

in color sets, 9-10 
foreground color, 9-12 
foregroundColor resource, 9-12 
f.prev_ workspace function, 11-51 
frame, 11-7, 11-8 
frames 

appearance, 11-6 

color resources, 11-7 

components, 11-10 

dynamic color, 11-6 

elements, 11-11 

mattes, 11-13 

tiling, 11-8 

title bar, 11-13 
FrontPanel keyword, 13-7 
front_panel_name, 13-26 
functions 

contexts, 11-32 

window manager, 11-32 
Functions field, workspace manager, 
13-12 



functions, multiple in workspace 

manager, 13-13 
functionSjWindow manager, 11-32 



general font resources, 10-4 
generic controls, 13-8 
geometry 

progress control, 13-12 

syntax, 8-15 

workspace manager, 13-4 

workspace manager controls, 13-11 
gettyLine resource, 5-19 
gettySpeed resource, 5-19 
Grab Application button, 10-5, 10-6 

H 

Help 

Index Window, 9-19 

Snapshot Window, 9-19 

Viewer Window, 9-19 
Help control, 13-21 
help manager 

app-defaults, 9-19 

colors, 9-14 

customizing, 9-18 

opening and closing, 9-19 

syntax of resources, 9-20 
hexadecimal color values, 8-13 
HIGH_COLOR color use, 9-9 
HOME environment variable, 5-7, 5-8 
home session database, 6-2 
host 

application, 4-1 

data, 4-1 

environment, 8-2 

information, 6-8 
host name 

changing, 4-13 
hostname 

data files, 4-2 



lndex-6 



Index 



qualifier, 4-3 
hostname server, Yellow Pages, 4-15 
hosts, 9-7 

distributed, 4-1 
Hosts dialog box, 4-12 
hpterm, 9-2 

cached, 8-11, 9-3 

halting, 6-9 

terminal characteristics, 9-3 

I 

icon, 11-15 

appearance, 11-15 

color, 11-17 

context, 11-32 

custom pixmaps, 11-23 

decoration, 11-17 

font in label, 11-18 

for actions, 12-20 

for file types, 12-11 

image, 11-17 

in icon box, 11-22 

label, 11-15, 11-16, 11-18 

organization, 11-18 

parts of, 11-15 

placement, 11-19 

size, 11-20, 11-21 

stand-alone, 11-19 

tile, 11-17 
iconAutoPlace resource, 11-19 
icon box, 11-21 

appearance of icons, 11-22 

closing, 11-23 

minimizing, 11-23 

orientation, 11-22 

resources, 11-23 

size, 11-22 

specifying, 11-21 
iconBoxGeometry resource, 11-22 
iconDecoration resource, 11-17, 11-22 
iconPlacementMargin resource, 11-19 



iconPlacement resource, 11-19 
inactiveColorSetId resource, 8-13, 9-14, 

11-6 
index (help manager) 

resources, 9-20 
Index window, 9-19 
inetd process, 4-9 
inetd.sec file, 4-7, 6-10 

changing host name, 4-14 
init process, 5-2 
inittab file, 4-4, 5-4 
input devices, 2-2, 3-4 
italic text, meaning, 1-3 
ITE characteristics, 5-19 
ITE devices, 5-20 

K 

KBD_LANG environment variable, 3-9 

key bindings, 11-43 

keyboard 

special keys, 11-43 
keyboard bindings, 11-43 

context, 11-44 

default, 11-45 

file containing, 11-3 

modifying, 11-46 

syntax, 11-43 
keyboard click, 9-17 
keyboard focus policy, 11-49 
keyboardFocusPolicy resource, 11-48 
keyboard settings, 6-8 
keys resource, 6-7 
keys shown typographically, 1-3 
keywords 

workspace manager, 13-16 
kill command, 8-11 
killing 

processes, 7-5 

programs, 7-5 
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label 

icon, 11-15 
LANG environment variable, 3-6, 5-8 
language-dependent files, 11-3, 13-6 
language-dependent resources, 8-2 
language, setting with a vuelogin 

resource, 3-7 
LINES environment variable, 11-52 
local-apps, 12-14 
local clients, 7-4 
local host, 4-1 
location of windows, 8-15 
lock control, 6-7 
Lock control, 13-21 
locking the display, 6-6 
login 

remote host, 4-15 
.login file, 5-8 
login manager, 5-1 

configuration files, 5-2 

executables, 5-2 

vuegreet, 5-2 

vuehello, 5-2 

vuelogin, 5-2 
login screen 

appearance, 5-15 
logins on remote hosts, 4-15 
LOGNAME environment variable, b-i 
logo 

changing, 5-15 
Logo control, 13-21 
logout, 6-8 
LOW_COLOR color use, 9-9 

M 

Mail control, 13-2 
MAIL environment variable, 5-9 
manual conventions, 1-3 
manual organization, 1-2 
MAP action type 



alternate action field, 12-21 

specifying, 12-21 
mapping actions, 12-21 
mapping colors, 9-14 
mattes, 11-13 
maxCache resource, 9-4 
maximize button, 11-11 
MEDIUM-COLOR color use, 9-9 
menu button, 11-11 
menus 

accelerators, 11-37 

appearance, 11-15 

changing, 11-38 

creating, 11-38 

greyed out entries, 11-32 

mnemonics, 11-37 

syntax, 11-37 

window, 11-38 

window manager, 11-3, 11-36 
message catalogs — the NLSPATH 

environment variable, 3-8 
message of the day, 5-15 
minCache resource, 9-4 
minimize button, 11-11 
mnemonics, 11-37 
mode field 

file type definitions, 12-10 
modifying 

colors, 11-31 

patterns, 11-31 

shapes, 11-31 
monitoring file status, 13-14 
motd file, 5-15 
mouse 

acceleration and threshold, 9-17 

bindings, 11-39 

double-click time, 9-17 

operations, 11-39 
mserve, 4-10 

multiClickTime resource, 9-17 
multiple displays 
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configuring, 5-18 

resources, 5-19 

using different resources, 5-18 
multiple screens 

Broadcast Message Server, 3-3 

session manager, 3-3, 6-10 

Starbase, 3-3 

switching workspaces, 11-51 

window manager, 3-3, 11-50 
multiscreen resource, 11-50 
multi-tasking, 2-1 

MWMSHELL environment variable, 
13-13 

N 

names of clients, 8-17 
names of resources, 8-17 
naming clients, 8-17 
naming conventions 

file management database, 12-2 
native language 

customizing HP VUE, 3-6 
networking 

security, 4-9 
nfs mounting, 4-3 

security, 4-12 
NFS mounting, 13-13 
non-clients, 7-4 
non-standard clients 

running, 6-10 
NO-STDIO window type, 12-22 
no windows mode, 5-18, 14-3 
numberOfSwitchRows resource, 13-18 

O 

offset 

workspace manager geometry, 13-4 
operating system, 2-1 
option on command line, 8-2 
options 

command-line, 7-2 



command-line syntax, 7-2 

display, 7-3 
other NLS environment variables, 3-8 
OUTPUT-ONLY window type, 12-22 



palette configurations, 9-9 
palettes, 9-8 

color usage, 9-12 
panel-control, 13-8 
passSelectButton resource, 11-49 
PATH environment variable, 5-7, 5-8 
PERM-TERMINAL window type, 12-22 
personal action definitions, 12-4 
personal-apps, 12-14 
personal file types, 12-4 
PID, 7-5 
pixmap 

icon image, 11-17 

icons, 11-23 

in workspace manager, 13-6 

window frames, 11-8 
pixmaps 

created by style manager, 9-10 
pointer focus policy, 11-49 
precedence of resources, 8-18 
predefined controls, 13-8 

editing, 13-17 
primaryColorSetId resource, 8-13, 9-14 
print spooler, 5-2 
processes, 7-5 
process ID, 7-5 
.profile file, 5-8 
programs 

running, 7-4 

setting colors, 8-13 

stopping, 7-4, 7-5 
progress control 

geometry, 13-12 
push button 

adding to workspace manager, 13-23 
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specifying, 13-10 
push buttons 

in workspace manager, 13-2 



queryServerSettings resource, 6-8 



R4 server, 5-21 
read-only indicators, 13-2 
redrawing the screen, 11-52 
reducing color usage, 9-16 
remote access 

different domains, 4-3 
remote data,accessing, 4-2 
remote execution, 4-5 

access rights, 4-7 

actions, 12-27 

configuration for, 4-7 

environment, 4-8 

requirements, 4-5 
remote execution and NLS, 3-11 
remote execution host, 4-7, 12-27 
remote host 

logins, 4-15 
remote hosts 

accessing, 12-27 

enabling, 12-27 
repainting the screen, 11-52 
resize, 11-52 
resize border, 11-11 
Resource editor action, 8-7 
resource file 

merging 

into RESOURCE-MANAGER 
property, 8-7 
resource manager, 8-1 
RESOURCE-MANAGER property, 
8-1, 8-3, 11-2 

downloading, 8-10 

hierarchy of resources, 8-2 



removing, 8-10 

stored by session manager, 8-5 
resources, 10-5 
adding, 8-6, 8-7 
app-defaults, 8-2 
by client class, 8-17 
by client name, 8-17 
cached clients, 8-11 
changing, 8-4 

changing between sessions, 8-10 
changing during a session, 6-5 
changing dynamically, 8-5 
changing with style manager, 8-5 
classes, 8-17 
client, 7-2, 8-1 
color, 8-12, 9-15 
color set, 8-13 
commented, 8-12 
deleting, 8-10 
editing, 8-10 
focus policy, 11-48 
font, 10-1, 10-2, 10-6 
fonts, 10-3 

for help manager, 9-19, 9-20 
for HP VUE clients, 9-1 
for login screen appearance, 5-15 
geometry, 8-15 
hierarchy, 8-3 

how acquired by a client, 8-1 
icon size, 11-21 

loaded by session manager, 8-3 
matte, 11-13 
merging, 8-7 

modifying app-defaults, 9-2 
modifying on a per-user basis, 9-2 
names, 8-17 
precedence, 8-18, 9-15 
style manager, 9-5, 10-1, 10-3 
supplied by command line, 8-2 
syntax, 8-12 
syntax for window manager, 11-3 



index-10 



Indei 



terminal charactertics, 9-3 

using a resource file, 8-10 

vuecommand, 9-4 

wildcards, 8-19 

window frame, 11-8 

window frame, coloring, 11-13 

window manager, 11-1 

workspace manager, 13-2, 13-3 
resources, lanuage-dependent, 3-8 
resources resource, 5-18 
restoring sessions 

files, 6-2 
rgb values, 8-13 
.rhosts file, 4-12 

syntax, 4-13 
root context, 11-32 
root cursor, 11-31 
root window, 11-26, 11-31 
rowBackgroundPixmap resource, 13-6 
row_name, 13-7 
row name, 13-3 
rowSpacing resource, 13-5 
run levels 

set in inittab, 5-2 
running 

programs, 7-4 



scalable typeface 

definition, 10-1 
screen 

repainting, 11-52 

specifying, 7-2 
screen configuration, 3-1 

default, 3-2 
screen configurations 

default, 3-2 
screenList resource, 11-50 
screen names, 11-5 
screens 

multiple, 3-3, 11-50 



with session manager, 6-10 
screen saver, 6-8 

script, used to start a session, 14-1 
search path 

file management database, 12-5 

of action definitions, 12-18 
secondaryColorSetId resource, 8-13, 

9-14 
security, 4-9 

access without login, 4-12 

display access, 4-11 

nfs, 4-12 
Security 

limiting display access, 4-11 
select color 

in color sets, 9-10 
server, 2-2 

display, 2-2 

foreign, 5-20 

R4, 5-21 

resources for, 5-18 

syntax for specifying, 5-16 

X, 2-2 
servers 

on multiple displays, 5-19 
server settings 

saving, 6-8 
servers resource, 5-19 
session 

canceling, 6-9 

changing resources during, 6-5 

definition, 6-1 

first, 6-6 

run from a script, 14-1 

startup, 6-6 

termination, 5-5, 6-8 
sessionetc file, 6-6, 6-10 
session manager 

database, 6-2 

database stored at end of session, 6-8 

default files, 6-3 
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editing resource files, 8-10 

error logging, 6-7 

executable file, 6-2 

failing to start, 6-8, 6-10 

files, 6-1 

Hosts dialog box, 4-12 

how it works, 6-4 

loading resources, 8-3 

multiple screens, 3-3 

purpose, 6-1 

restoring the palette, 9-9 

running from a startup script, 14-1 

running non-saved applications, 6-10 

saving bell settings, 6-8 

saving host information, 6-8 

saving keyboard settings, 6-8 

saving screen saver information, 6-8 

saving server settings, 6-8 

saving startup information, 6-8 

starting the window manager, 6-5 

storing the RESOURCE_MANAGER 
property, 8-5 
session startup 

transition window, 5-15 
setting LANG in .vueprofile, 3-7 
setting the KBD_LANG environment 

variable, 3-9 
setting the LANG environment variable, 

3-6 
setting the language with a vuelogin 

resource, 3-7 
shadow colors, 9-10 

in color sets, 9-10 
shadowPixmaps resource, 9-10 
SHARED-OUTPUT window type, 12-22 
shell 

for workspace manager commands, 
13-13 
SHELL environment variable, 5-7, 5-8, 

13-13 
shut down of system, 5-22 



size 

action icons, 12-20 

file icon, 12-11 

icon box, 11-22 

icons, 11-20 

of workspace manager controls, 13-22 

specification, 8-12 
size of windows, 8-15 
Snapshot window, 9-19 
Softbench 

customizations, 15-4 

moving to HP VUE, 15-1 

on system system as HP VUE, 15-2 

quitting, 15-4 

removing, 15-3 

.softinit file, 15-4 
.softenv file, 4-8 
softenv file, 15-2 
•softinit file, 6-10, 15-4 
softinit file, 15-2 
softmsgsrv files, 6-10 
softspcd files, 6-10 
softtypes, 15-2 
solitary systems 

configuring, 6-10 
space characters, 1-4 
spc, 4-10 

special input devices, 3-4 
Starbase 

colors, 3-4 

environment variables, 3-5 

multiple screens, 3-3 
starting 

clients, 7-4 

non-clients, 7-4 
starting HP VUE, 5-6 
startup 

customizing, 5-7 
Startup dialog box, 6-4 
startup information, 6-8 
startup resource, 5-18 
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stopping 

clients, 7-4 

programs, 7-4, 7-5 
stopping a session, 6-9 
stopping HP VUE, 5-22 
string variables, 12-12 
style manager, 9-4 

changing resources, 8-5 

changing resources with, 8-5 

color resource written to, 9-15 

colors, 9-14 

computing rgb values from, 8-14 

customizations, 9-6 

dialog boxes, 9-6 

fonts, 10-1, 10-2, 10-3 

mouse settings, 9-17 

opening and closing, 9-5 

resources, 9-5, 10-1 

setting client-specific fonts, 10-6 

setting foreground color, 9-12 

when changes take effect, 9-17 
Sub-Process Control Daemon, 4-5, 15-1, 

15-2 
symbolic link, file access using, 4-5 
symbolic links 

applications directories, 12-14 

backdrops directory, 11-27 

in action definition database, 12-14 
symbolic names 

in application window, 12-6 
syntax 

command-line, 7-1 

command-line options, 7-2 

display, 7-3 

mwm resource, 11-13, 11-38 

vuewm resource, 11-15 

workspace manager resources, 13-3 
syntax of colors, 8-13 
syntax of resources, 8-12 
sys.resources file, 6-3 
sysrm command, 15-3 



sys. session file, 6-3 
system-apps, 12-14 
system boot, 5-2 
system font, 10-2 
system fonts, 10-2, 10-3 
sys.vuewmrc file, 11-3, 13-6 



TERM environment variable, 5-9, 11-52 
terminal characteristics, 9-3 
Terminal control, 13-21 
terminal emulator 

used to run non-clients, 7-4 
terminallcon resource, 9-4 
terminalName resource, 9-4 
terminals 

supporting XDMCP, 5-21 
TERMINAL window type, 12-22 
terminating sessions, 6-8 
tile 

icons, 11-17 

window frames, 11-6, 11-8 
tiling workspace manager, 13-6 
time zone environment variable, 5-13 
title bar, 11-11 

resources for, 11-13 
toggle button 

adding to workspace manager, 13-23 

specifying, 13-10 
toggle buttons 

workspace manager, 13-2 
tools directory, 12-5 
topic (help manager) 

resources, 9-20 
transientDecoration resource, 11-10 
trash can control, 13-14 
.trashinfo file, 13-15 
ttyModes resource, 9-3 
types directory, 12-2 
TypesDir resource, 12-5 
typographical conventions, 1-3 
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typographical tips, 1-4 

TZ environment variable, 5-9, 5-13 

U 

unmapping clients, 8-11 
update 

effect on file types and action 
definitions, 12-3 

effect on window manager, 11-3 
upper-case letters, 1-4 
useBlinkinglndicator resource, 13-19 
useClientlcon resource, 11-17 
useFrontPanel resource, 13-3 
uselconBox resource, 11-21 
useMessaging resource, 14-3 
USER environment variable, 5-7, 5-8 
user font, 10-2 
user fonts, 10-2, 10-3 



variables, string, 12-12 
version, displaying, 13-21 
VIEW action 

large files, 9-21 
viewer (help manager) 

resources, 9-20 
Viewer window, 9-19 
vueauth-server file, 5-3 
Vuebackdrops directory, 11-25 
VueButtonBindings, 11-43 
vuecommand, 2-5 
vuecommand resources, 9-4 
vuefile, 9-21 
vuegreet, 5-2, 5-5 
vuehello, 5-2, 5-5 
vuehello client, 5-15 
vuehelp 

customizing, 9-18 
VueKey Bindings, 11-46 
vuelogin, 5-2 

colors, 9-16 



default DISPLAY value, 5-14 

environment variables built in, 5-8 

how it works, 5-4 

hub systems, 5-3 

setting terminal characteristics, 9-3 

started by init, 5-2 

user-specific files, 5-4 
Vuelogin directory, 5-3 
vuelogin resource, setting language with, 

3-7 
•vueprofile file, 5-4, 5-9 

when read, 5-5 
.vueprofile, setting LANG, 3-7 
vue.resources 

editing, 8-10 

fonts, 10-5 
vue.resources file, 6-2 
VueRootMenu, 11-38 
vue.session 

editing, 8-10 
vuesession, 6-2 

run by vuelogin, 5-5 
vue.session file, 6-2 
vue.settings file, 6-2 
vuestyle, 9-4 

default font resources, 10-3 
Vue.TypesDir resource, 12-5 

default value, 12-6 
vuewm, 11-3 

command-line options, 11-1 

multiscreen option, 11-50 

screens option, 11-50 

started by session manager, 6-5 

starting without session manager, 
11-1 
vuewmblank, 13-16, 13-17 
vuewmbox, 11-21, 11-23, 13-16, 13-17 
vuewmbusy, 13-16, 13-17, 13-19 

geometry, 13-12 
vuewmclock, 13-16, 13-17 
vuewmdate, 13-16, 13-17 
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fonts, 13-19 

format, 13-19 
vuewmname, 13-16, 13-17 
vuewmrc file, 11-3, 13-6 
vuewmrib, 13-16, 13-17 
vuewm, see window manager, 11-50 

W 

white space, 1-4 
wildcards, 8-19 
window 

information, 11-52 

size and placement, 11-47 
window context, 11-32 
window manager, 11-36 

affected by update, 11-3 

alternative, 6-5 

alternatives, 11-53 

backdrops, 11-24 

components, 11-3 

configuration files, 11-3 

default behavior, 11-49 

default menus, 11-37 

dialog box appearance, 11-15 

fonts, 11-10 

frame appearance, 11-6 

frame color, 11-7 

frame components, 11-10 

functions, 11-32 

introduction to, 2-3 

language-dependent files, 11-3 

mattes, 11-13 

menus, 11-36 

menu syntax, 11-37 

multiple screens, 3-3, 11-50 

number of workspaces, 11-5 

OSF/Motif behavior, 11-49 

resource files, 11-1 

run from a startup script, 14-3 

running without HP VUE, 14-3 



starting without session manager, 
11-1 

syntax of resources, 11-3 

workspace names, 11-5 
window manager functions 

in workspace manager, 13-12 
window menu, 11-37 

changing, 11-38 
windowMenu resource, 11-38 
windows 

managing, 11-1 

setting colors, 8-13 

size and location, 8-15 
window support for actions, 12-22 
window system, 2-2 
WM_HINTS property, 11-17 
wmStartupCommand, 11-53 

multiple screens, 11-50 
wmStartupCommand resource, 6-5, 

14-2 
workspace 

adding and deleting, 11-5 

backdrops, 11-24 

names, 11-5 
workspace backdrops, 11-31 
workspace cursor, 11-31 
workspaceList command-line option, 

7-3 
workspaceList resource, 11-5 
workspace manager, 13-2 

actions, 13-12 

active clients in, 13-2 

adding a client window, 13-24 

adding a control, 13-22 

adding a drop zone, 13-25 

adding a file indicator, 13-25 

appearance, 13-5 

appearance resources, 13-3 

border around controls, 13-22 

color, 13-5 

configuration files, 11-3, 13-6 
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contents, 13-6 

control names, 13-9 

control options, 13-2 

control type specifications, 13-10 

customizing, 13-21 

default, 13-19 

default colors, 13-5 

drop affects, 13-14 

drop zone, 13-2 

file status control, 13-14 

geometry, 13-4 

geometry of controls, 13-11 

keywords, 13-16 

location, 13-3 

new, 13-25 

predefined controls, 13-8, 13-16 

push buttons, 13-2 

read-only indicators, 13-2 

removing a control, 13-22 

resources, 13-2, 13-3 

shell for commands, 13-13 

size of controls, 13-22 

spacing between controls, 13-5 

syntax, 13-6, 13-8 

tiling, 13-6 

toggle buttons, 13-2 

trash can, 13-14 

turning off, 13-3 

vertical, 13-26 

vuewmblank, 13-16, 13-17 

vuewmbox, 13-16, 13-17 

vuewmbusy, 13-16, 13-17 

vuewmclock, 13-16, 13-17 

vuewmdate, 13-16, 13-17 

vuewmname, 13-16, 13-17 

vuewmswtch, 13-16, 13-17 

workspace switch, 13-18 
workspace menu, 11-37, 11-38 
workspaces 

introduction to, 2-4 

starting clients in, 7-3 



workspaceSjin multiple screens, 11-51 
workspace switch 

appearance, 11-15, 13-18 

color, 13-18 
writeXrdblmmediate resource, 8-5, 9-17 
wsButtonBorder resource, 13-18 
wsButtonShadowThickness resource, 

13-18 
wsButtonSpacing resource, 13-18 



XO.hosts file, 4-11 
XOscreens, 3-1 
XOscreens file, 3-2 

used with X* .hosts file, 3-3 
XAPPLRESDIR variable, 8-2 
XAUTHORITY environment variable, 

5-8 
XAUTHORITYenvironment variable, 

5-7 
.Xauthority file, 5-4 
Xconfig file, 5-3, 5-4, 5-19 

editing for Starbase, 3-5 
.Xdefaults 

not used by HP VUE, 8-3 
.Xdefaults-host file, 8-2 
XDMCP 

protocol, 5-21 

terminals supporting, 5-21 
XENVIRONMENT variable, 8-2 
Xerrors file, 5-3 
xfd, 10-7 
xhost, 9-7 
X*hosts, 4-7 
X* .hosts file 

used with X*screens file, 3-3 
X*hosts file, 4-11 
xinitcolormap, 3-4 
xlfd name, 10-6 
xload client, 9-21 
Xpid file, 5-3 
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xrdb, 6-5, 8-1, 8-5, 8-6, 8-19 

changing and deleting resources, 8-10 

customizing workspace manager, 13-3 

font resources, 10-7 

loading window manager resources, 
11-2 

merge option, 8-7 

nocpp option, 8-10, 8-12 

resource editor, 8-7 

used interactively, 8-7 

used to add resources, 8-6 
xrdb resource, 5-18 
xrefresh, 11-52 
Xreset file, 5-3, 5-5 
Xresources file, 5-3, 5-4, 5-15 
Xrest, 5-7 
xrm option 

for starting clients in workspaces, 7-3 
X*screens file, 3-2 
X server, 2-2 
Xservers file, 5-3, 5-4, 5-16, 5-18, 6-10 

editing for X-terminals, 5-21 
Xsession file, 5-3, 5-5 



edit for Starbase, 3-4 
Xsession;setting environment variables, 

5-9 
xset, 9-6 
xsetroot, 11-31 

executing for a session, 6-6 
Xstartup file, 5-3, 5-5 

for customizing startup, 5-7 
xterm 

cached, 8-11, 9-3 

terminal characteristics, 9-3 
X-terminals, 5-20 

editing Xservers for, 5-21 

protocols, 5-21 
XUSERFILESEARCHPATH variable, 

3-8 
X Window System 

description, 2-2 
xwininfo, 11-52 
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